home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
084
/
qdoc_200.arc
/
QUICKBBS.DOC
next >
Wrap
Text File
|
1988-03-30
|
207KB
|
5,761 lines
**** ** *** ****** ****** ****
** ** ** ** ** ** ** ** **
** ** ** ** *** **** ** ** ** ** ** ** ***
** ** ** ** ** ** ** ** ** ***** ***** ***
** *** ** ** ** ** **** ** ** ** ** ***
**** ** ** ** ** ** ** ** ** ** ** ** ** **
*** *** ** **** **** *** ** ****** ****** ****
Version 2.00
The Quick Bulletin Board System
By
Adam Hudson
Documentation By
Claude N. Warren, Jr.
Contents
Introduction Intro-1
Licensing Information Intro-1
Explanation of Documentation Changes Intro-1
Overview - General Intro-2
Overview - New Sysop Intro-2
Overview - New to QuickBBS Intro-2
System Configuration for QuickBBS Intro-3
Notation Conventions Intro-4
Software 1
Required Software 1
Optional Software 1
Installing the Software 1
QCONFIG 2
Modem Parameters and System Paths 2
Restrictions, Net Mail, and New User Parameters 4
Other Misc. Parameters 6
Message Board Configuration 8
Event Editing 10
Menus 10
A Discussion of Menu Topology 10
Tips on Setting up Menus 12
Setting up Menus 12
Menu Types and Optional Data 15
Automatic Execution from Menu 24
Example of Building Menus 25
User File 30
Getting Yourself into the User File 30
Editing the User File 31
Packing the User File 33
Sorting the User File 34
Message File 34
Cleaning the Message File 34
Packing the Message File 35
Miscellaneous 36
Bringing the Board On Line 36
Keys that Work While A user is on line 36
The Flags 37
Colors 38
Error Handling in QuickBBS 38
Reseting the System Usage Graph 38
Reseting the Number of Callers Counter 39
External Files 39
Setting up the External Support Files 39
ASCII and ANSI File Control Characters 43
Net And Echo Mail 45
Required Software for Net Mail 45
An Overview of the Net Organization 45
How to Apply for a Net/Node Number 45
Overview of Net Mail Operation 45
Configuring QuickBBS for Net Mail 46
Compiling the Nodelist for QuickBBS 46
Two Techniques for Mail Handling 47
Continuous Mailers 47
Non Continuous Mailers 47
Getting Mail into the Net from QuickBBS 48
Determining When Net Mail was Entered. 48
Getting Messages from the Net into QuickBBS 48
Overview of Echo Mail 49
Configuring QuickBBS for Echo Mail 49
Getting Echo Mail into the Net from QuickBBS 49
Killing Duplicate Echo Messages 54
Batch File Examples Appendix A
Binkley Batch File Examples A-1
DataBridge Batch file Examples A-6
Dutchie Batch File Examples A-9
Non-Continuous Mailer Batch File Example A-11
SEADog Batch File Examples A-12
QuickBBS Batch File Examples A-16
ASCII and ANSI File Control Characters Appendix B
Keys That Work While A User is On Line Appendix C
Menu Types and Optional Data Appendix D
Questionnaire Command Language Appendix E
Full Screen Editor Interface Appendix F
**********************************************************************
** QuickBBS Introduction **
**********************************************************************
Licensing Information
--------- -----------
QuickBBS is copyrighted material of Adam Hudson. This
documentation is copyrighted by Claude N. Warren, Jr. and Adam Hudson.
It may be used and copied only under the following guidelines.
You may use QuickBBS on your system to test it's suitability for
your application. After a determination of suitability you must
register your copy.
You may NOT use QuickBBS in any governmental, institutional, or
pay system unless you register your copy.
You may NOT use QuickBBS in any unlawful or illegal manner.
You may distribute QuickBBS free of charge provided that no
charge is levied. This excludes charges for time online for pay
systems.
You may distribute QuickBBS for a fee provided that each copy of
QuickBBS that you distribute is pre-registered. Pay systems are
excempted from this clause.
You may distribute QuickBBS provided that no changes are made to
the programs or documentation.
A registration fee of $25 is required for each copy of QuickBBS
that you use. Site licensing of QuickBBS is available and will be
reviewed on a case by case basis.
Non-profit and Not-for-profit corporations may obtain an
exclusion from the licensing requirements. Applications for exclusion
will be reviewed on a case by case basis.
Send all registration fees, site licensing requests, and requests
of licensing exclusion to:
Adam Hudson
8020-A Holland Ct.
Arvada Co
80005
Please include your name, address, voice phone number, and either your net
node number or a self addressed stamped envelope.
MEDIT Design, control, authorizaton, and security technology used
under licence from Philip L. Becker.
Thanks to Dean Porter for his assistance in the development of
some of the fossil and search routines.
Explanation of Documentation Changes
----------- -- ------------- -------
QuickBBS Introduction - Page Intro-1
As this is the second version of QuickBBS there are many boards
that will be upgrading to the new version as well as sysops changing
from other systems and new sysops running their first Bulletin Board
System. In order to handle all three groups the structure of the
documentation has been changed. The basic concept is that each
program that is part of the QuickBBS package will be covered
separately.
Overview - General
-------- - -------
QuickBBS is a fully selfcontained Bulletin Board program. The
program comes in three packages.
QEXE_200.ARC Full Stand Alone QuickBBS Package
QNET_200.ARC Net and Echo Mail Option
QDOC_200.ARC This document and a structure file
The first of these is QEXE_200.ARC. This package contains all of the
programs necessary for the implementation of a stand alone bulletin
board. The section I of this document deals with how to set up and
operate the stand alone package. YOU SHOULD BECOME FAMILURE WITH THE
STAND ALONE BOARD BEFORE ATTEMPTING TO ADD NETMAIL AND ECHO MAIL.
The second package, QNET_200.ARC, is the Net and Echo mail
package. This package contains all programs necessary to allow the
stand alone system to generate and import netmail and echo mail
messages. YOU WILL NEED A MAILER TO OPERATE THE NETMAIL PACKAGE. The
mailer IS NOT included in this package. The section II of this
document will deal with the netmail and echomail programs.
QuickBBS uses a database format for the message base. This means
that if you are currently running an Opus or other file oriented
message base system you should realize a significant increase in disk
space.
QuickBBS uses 'hot keys'. This means that the user does not have
to wait for the prompt to enter a menu selection. This will allow
regular users of your system to move through your menus at lightning
speed.
Sysop level users are allowed to forward, move, or delete any
message on any board.
Overview - New Sysop
-------- - --- -----
New sysops should read all of section I. When you have QuickBBS
running as a stand alone board you should then read section II if you
plan to implement net or echo mail. You will find that there is an
example of a batch file to run QuickBBS as a stand alone board as well
as with a number of mailers.
Overview - New To QuickBBS
QuickBBS Introduction - Page Intro-2
-------- - --- -- --------
If you are currently running another BBS program then you will
have a good grasp on some of the concepts found in QuickBBS. Although
there are too many BBS programs available to cover the differences
between Quick and what you are running now. Here are some general
guidelines.
QuickBBS uses a database format for the message base. If you are
running OPUS or some similar file based message storage BBS then you
should pay close attention to the sections on the message base.
QuickBBS requires that you build all menus. There are no
internal menu structures. Most BBS programs have a default menu.
QuickBBS does not. This seems to be the hardest concept for new
sysops to grasp. Please pay close attention to the section on
building menus and the discussion of menu topologies.
QuickBBS net mail and echo mail operation is, in many ways
similar to other BBS's. You should find that, with the exception of
your mailer specific programs, you should have no need for external
programs. There are batch files that demonstrate how to run QuickBBS
with a variety of mailers.
System Configuration for QuickBBS
---------------------------------
QuickBBS was written on an IBM PC/XT with 640 KB of memory, with
a Hayes 1200 Baud internal modem. QuickBBS has been Beta Tested on
the following configurations.
Computer Memory Modem type
-------------- -------- ---------------------------------------
IBM PC/XT 640 kb Hayes 1200 internal
IBM PC/XT 640 kb USRobotics internal 2400
Tandy 1000A 640 kb USRobotics Microlink 1200 internal
Tandy 1000A 640 kb USRobotics Courier 2400 external
IBM PS2 Mod 50 1024 kb IBM 1200 external Model 5841
IBM PC/AT 512 kb Hayes 1200 internal
IBM PC 640 kb INCOM 2400 external
KAYPRO 4.77mhz 768 kb Hayes 1200 external old style 8 pos dip
switch
MAXUM 8mhz 3 mb MAXUM 2400 external
PACKARD BELL AT 640 kb USRobotics Courier 2400 External
LEADING EDGE 640 kb EverEx 2400 Internal
NCR PC8 AT 512 kb EverEx 2400 Internal
While it may be possible to operate QuickBBS on a Dual Floppy
drive system. It is highly recommended that you have, at a minimum, a
5 Meg Hard Drive as the message base alone can easily exceed 2
megabytes. The Minimum Memory requirement is 256 Kb. The QuickBBS
software has been operated on the System configurations listed above.
Results of operation on other hardware configurations may be
unpredictable. Basically if you have an IBM PC/XT/AT or a True
QuickBBS Introduction - Page Intro-3
Compatible, and a Hayes modem or True Compatible, you should have no
problems. However if you do encounter problems with your hardware
config Please notify Adam Hudson on FidoNet 104/24, or via the
QuickBBS echo, so that this problem might be corrected.
If you operate QuickBBS in conjunction with a FidoNet Mailer or
if you use any DOOR software then the Memory requirement will be
greater. While QuickBBS will operate on 256 kb of memory it is
recommended that you have at least 512 kb.
Ram Drives have been used with QuickBBS with quite a bit of
sucess, but BEWARE, ram drives are very dangerous. It is pretty safe
to copy your menus and text files into a ram drive every time your
system boot's but if you make any changes, you will want to make sure
to copy the changes from ram to the hard drive. You will never want
your Message or User Base's kept in Ram Drive unless you have the
system copy these files to the Hard Drive every time a user logs off.
This will insure minimum losses in the event of a power failure or
brown out.
Notation Conventions
-------- -----------
In this manual all user input will be enclosed in quotes (") all
special keys will be delimited by { and } (i.e. "{PgDn}" means press
the Page Down key (3 on the numeric pad)). All required input will be
delimited by < and >, all optional input will be delimited by [ and ].
QuickBBS Introduction - Page Intro-4
**********************************************************************
** QuickBBS Version 2.00 Documentation **
**********************************************************************
Required Software
-------- --------
Besides the QEXE_200.ARC file you will need DOS and a fossil
driver. QuickBBS is known to work with the X00 fossil. At this time
the OpusCom driver is known to have problems with uploads. You will
need to find a FOSSIL that works on your machine.
In addition to the required software you will need to set the
following commands in your CONFIG.SYS file:
FILES=20
BUFFERS=25
If you already have these values set higher than indicated here then
you may leave them as they are. For more information on the
CONFIG.SYS file please refer to you DOS manual.
Optional Software
-------- --------
QuickBBS will use WXMODEM.COM to perform windowed XModem protocol
transfers. This program is not included in the QEXE_200.ARC archive
but is available on may BBS's. It is a separate shareware program.
Please register it separately from QuickBBS and in accordance with
the licensing agreement contained with the program. To use this
protocol WXMODEM.COM must be in the directory that QuickBBS is run
from.
QuickBBS will use DSZ.COM to perform Zmodem protocol transfers.
This program is not included in the QEXE_200.ARC archive but is
available on many BBS's. It is a separate shareware program. Please
register it separately from QuickBBS and in accordance wit the
licensing agreement contained with the program.
To use Zmodem protocol the DSZ program must be in the directory
that QuickBBS is run from. The environment variable DSZLOG must be
set as follows: DSZLOG=<DRIVE><QUICKBBS PATH>\QDSZ.LOG. Where
<Drive> and <QuickBBS Path> point to the directory that QuickBBS is
run from. If you do not know how to set an environment variable see
the SET command in you DOS manual.
At this time SHEDIT.EXE is the only full screen message editor
that works with QuickBBS. This program is in the Beta test stages and
my be released shortly. This is a seperate shareware program. Please
register it separately from QuickBBS and in accordance with the
licensing agreement that accompanies the program.
Installing the Software
---------- --- --------
At this time there has been no successful installation of
QuickBBS on a floppy system. This doesn't mean that it is not
possible just that it hasn't been done yet. To install QuickBBS make
QuickBBS Version 2.00 Documentation - Page 1
a directory on your hard disk from which you will want to run the
bulletin board. In this directory un-archive the QEXE_200.ARC
archive. Create a directory in which to store your menus. Create a
directory for miscellaneous text files. Create one directory for each
file area you will have. You will now need to run QCONFIG.EXE to set
up your system parameters.
QCONFIG
-------
QCONFIG is the main configuration program for QuickBBS. QCONFIG
is used to set the modem parameters, paths to the system files,
default user restrictions, miscellaneous parameters, configure the
message boards, and set the event schedule. To run QCONFIG type
"QCONFIG{Enter}". You will then see the following menu:
QuickBBS Configuration Utility Version 2.00
<1> ... Modem Parameters and System Paths
<2> ... Restriction, Net Mail, and New User Parameters
<3> ... Other Misc. Parameters (Part 1)
<4> ... Other Misc. Parameters (Part 2)
<M> ... Message Board Configuration
<E> ... Event Schedule Configuration
Press <ESC> to Quit to DOS and Save Configuration File
Choice:
Modem Parameters and System Paths
----- ---------- --- ------ -----
Select function 1 from the QCONFIG menu and you will see the
following menu:
Communications Port (1-8) ..........: 1
Maximum Baud Rate of Modem .........: 2400
Max. Tries Allowed to Init Modem ...: 10
Seconds to Wait for Connect ........: 30
Modem Initialize Command String ....: |ATE0F1M0Q0V1X1C1H0S0=1S7=15|
Modem Initialize Response ..........: OK
Modem Busy Command String ..........: |ATH1M0|
Modem Busy Response ................: OK
Response for 300 Baud Connect ......: CONNECT
Response for 1200 Baud Connect .....: CONNECT 1200
Response for 2400 Baud Connect .....: CONNECT 2400
Menu Files Path:
C:\QUICKBBS\MENUS\
Custom Text and ANSI Files Path:
C:\QUICKBBS\TXTFILES\
QuickBBS Version 2.00 Documentation - Page 2
Net Mail Path:
C:\MAIL\NETMAIL\
The first field will be extended with blocks. Use the up or down
arrows to change the active field. Change the each of the fields as
necessary.
If you are using a port other than 1 (for the technicaly minded
this is port 0 or com 1) change the value in the Communications Port
field.
The maximum baud rate should be set the the highest rate that
your modem will operate.
The maximum tries to initialize the modem will determine how many
times QuickBBS will attempt to set modem before aborting with an modem
initialization error.
The seconds to wait for connect will determine how long QuickBBS
will wait for a carrier before giving up and reinitializing the modem.
The modem initialize string is the string that will be used by
QuickBBS to set your modem. If you are using a front end mailer then
you will not need to worry about this field. If you are changing to
QuickBBS from some other software you can probably copy your current
initialization string. If you have never set up a bulletin board
before then you will need to consult you modem manual to ensure that
all of the commands listed in the default string are valid for your
modem. If you are currently running a communications program then you
should be able to use the initialization string for that program with
some modification. Please be sure that S0=1 is used so that your
modem will answer the phone. QuickBBS now supports several special
modem characters they are:
| Sends a carriage return
^ Raises DTR - will answer the phone
v Lower DTR - will not answer the phone
~ Pauses for 1/2 second
The modem initialize response should be set to correspond with
the response that your modem generates when it is initialized. If you
are using a front end mailer you do not need to set this field. Some
modems return numeric result codes, some strings (also called verbal),
most are programmable to return one or the other.
The modem busy command string is used when the bulletin board is
doing something and can not accept calls. For example when you log on
locally or when QuickBBS exits. There are two accepted methods of
doing this. The first, and oldest, is to drop the DTR so that the
modem can not answer the phone. This results in the caller getting a
ring without ever having your machine answer the phone. The
disadvantage is that the caller may think that your board is down.
The other method is to take the phone off of the hook. This is the
QuickBBS Version 2.00 Documentation - Page 3
default. NOTE: If you are using QuickBBS with a mailer you must
clear this field otherwise QuickBBS will take send the busy string to
the modem whenever it is finished processing.
The modem busy response is the response your modem will generate
if the modem busy command string is correctly executed.
The response for 300 baud connect, 1200 baud connect and 2400
baud connect is the response your modem generates for each of the
connects. Your modem must be able to generate different responses for
each of the connection speeds.
The Menu Files Path is the path to the directory that you created
for the menus.
Change the Custom Text and ANSI files path to the path you
created for the miscellaneous files.
The net mail files path at this time is the path to the nodelist
files that are associated with netmail. If you are not running a
front end mailer then you do not need to worry about this field.
Press "{Esc}" when all parameters appear correct. And you will
be returned to the first menu.
Restrictions, Net Mail, and New User Parameters
------------- --------- --- --- ---- ----------
Select option 2 from the QCONFIG main menu and you should see the
following menu:
Minimum Baud Rate to Logon .........: 300
Lowest Baud Rate to Use ANSI .......: 300
Lowest Baud Rate to File Transfer ..: 300
Hours for 300 Baud Access ..........: 00:00 to 24:00
Downloading Hours ..................: 00:00 to 24:00
Sysop Paging Hours .................: 00:00 to 24:00
Zone Number: 1 Net Node
Main Matrix Address ................: 0 0
Alternate Address #1 ...............: 0 0
Alternate Address #2 ...............: 0 0
Alternate Address #3 ...............: 0 0
Alternate Address #4 ...............: 0 0
Alternate Address #5 ...............: 0 0
Net Mail Board Number ..............: 1
New User Security Level ............: 5
New User Credit ....................: 0
New User A Flags ...................: --------
New User B Flags ...................: --------
New User C Flags ...................: --------
New User D Flags ...................: --------
QuickBBS Version 2.00 Documentation - Page 4
The minimum baud rate to logon is the minimum that a user must
use to gain access to your board. You can set this to any speed that
is less than or equal to your modem speed. The program does not check
to see if this is set lower than your maximum modem baud rate but if
you set this higher than your maximum modem speed then no one will be
able to get into the system.
The lowest baud rate to use ANSI is the slowest speed that you
will allow a user to use and still get the ANSI graphics. Adam and I
feel that this should be at least 1200 baud as 300 is, in our opinion,
too slow to effectively use ANSI graphics. If you do not know what
ANSI graphics are please read up on them in your DOS manual. They are
not required for QuickBBS operation but they do provide a means of
generating interesting screens and will add a lot to the flavor of
your board.
The lowest baud rate to file transfer is the slowest speed that
you will let a user use to upload or download files.
The hours for 300 baud access will allow you to restrict 300 baud
access to only specific hours. This is to allow you to cater to 300
baud users only when your system is usually not busy or whenever you
feel like it.
Downloading hours are the hours that you will allow downloading
on your system. Uploading is always allowed.
The sysop paging hours sets the hours that you will allow pages.
If a user attempts to page at times outside of these hours then he/she
will see a message indicating that the sysop is not available.
The zone number is used for net mail. The zone defines a large
geographic area. Zone 1 is North America, 2 is Europe, and 3 is the
Pacific Basin. If you are planning to use net mail then you should
set this field accordingly. This must be set to 1 or higher
regardless of whether or not you are using net mail.
The main matrix address is used for net mail. This address
consists of a net node combination that is usually expressed as
net/node. This number will be assigned to you by your net or regional
coordinator. (See the net mail section for more information about
applying for a net/node number) Do not use someone else's net/node
number. Do not set this field if you do not have a net node number.
The Alternate addresses are used for boards that have more than
one net/node number. These are usually network hosts, help nodes, and
other special cases. Do not set these unless you have an alternate
net/node number assigned to you.
The net mail board number is the number of the message board that
will be used for net mail. (board numbers are discussed later in this
section) Do not change this setting at this time.
The new user security level is the default security level
QuickBBS Version 2.00 Documentation - Page 5
assigned to a new user. Security levels can range from 0 to 32000.
If a user is assigned a security level of 0 he/she can not access the
board. Set the new user security level to 0 ONLY IF YOU WANT TO RUN A
PRIVATE (PRE-REGISTER) BOARD. The new user security level should be
to a low number.
New user credit is the net mail credit that each new user will
receive. When a user enters a net mail message that is destined for a
board that is outside of your toll free calling area then that user is
charged for the message. The net mail credit is applied toward that
charge. If the user does not have enough credit then the message is
not stored or sent and the user is informed that he/she does not have
enough credit to send the message. Most systems do not give credit to
new users.
Each of the flags, A through D, are actually 8 flags. The flags
allow you to allow users into areas based upon flag settings rather
than security levels. A more complete discussion of flags occurs
later in this document. You will probably not want to change the
default flag settings.
Other Misc. Parameters
----- ----- ----------
Select function 3 from the main QCONFIG menu and you should see
the following menu:
Use Extended Last Read Pointers ....: Y
Run QuickBBS in Monochrome .........: N
Write Directly to Screen Buffer ....: Y
Check for Snow on Screen Writes ....: N
Are One Word Names Allowed .........: N
Check for Mail at Logon ............: Y
Ask for Business/Data Phone ........: Y
Ask for Home/Voice Phone ...........: Y
Are ANSI Color/Graphics Available ..: N
Exit When Net/Echo Mail is Entered .: Y
Seconds Before Disconnect ..........: 120
Logon Time Limit (in minutes) ......: 10
Default Foreground Color (0-15) ....: 7
Default Background Color (0-15) ....: 0
Maximum Password Attempts ..........: 3
System Operator Name ...............: System Operator
Maximum Sysop Pages per Call .......: 3
Page Bell Length (in seconds) ......: 15
Origin Line: Unkown
Message Editor DOS Command String:
The extended last read pointers are used to keep track of the
last message read by each user. This will create a file called
LASTREAD.BBS. Turn this option on if you want to be able to read new
messages in the message areas.
QuickBBS Version 2.00 Documentation - Page 6
If you have a monochrome system you should run QuickBBS in
monochrome mode. This will only affect local operation. Remote
callers will still see the colors.
The write directly to the screen buffer will speed the updating
of the status line on the local console. As direct screen writes
often cause snow the snow check function will check for this and
attempt to correct the problem. Direct screen writes should not be
used in multi-tasking environments.
If you want to allow users to log on with one word names turn the
onw word name flag on.
QuickBBS will check for unread mail at logon. This will allow
callers to see what messages they have waiting as well as read and
respond to them.
When a new user calls the system QuickBBS will ask several
questions that are stored in the User file. The business/data phone
and the home/voice phone may either be asked for or not.
If ANSI graphic screens are available on your system you should
set the ANSI graphics flag on. Otherwise the system will not check
for them and will not ask the user if he/she wants to use them.
If you want QuickBBS to exit with an errorlevel when Net and/or
Echo mail is entered you should set the next flag on. This is usually
done on systems with continuous mailers.
The seconds before disconnect is the amount of time that QuickBBS
will wait before it logs the user off with an inactivity disconnect.
The logon time limit is the amount of time that QuickBBS will
allow the user to complete the login sequence. This should be long
enough for a new user to complete any questionnaires and read any
introductory information that you display to them.
The default colors are the colors that will be used if no other
colors are specified in the menu. (Please see the color chart in the
appendix) The defaults are low intensity white on black.
The maximum password attempts is the number of times a user may
attempt to enter the correct password before they are denied access
and the phone is disconnected.
The system operator name should be set to your name or the name
you will use as the sysop.
The maximum sysop pages per call is the number of times that a
user may page the sysop in one session. Once this limit has been
reached the user will be told that he/she may not page the sysop any
more times during the current session.
QuickBBS Version 2.00 Documentation - Page 7
The page bell length determines how long the bell will sound each
time the sysop is paged.
The origin line is the line that will be used as the default
origin line in the echo areas. You should not include your net/node
address as QuickBBS will add this automatically. If you do not use
echo mail you do not need to set this.
The message editor DOS command string should contain the name of any
external full screen message editor that you are using. The editor must
conform to the requirements listed in the optional software section of this
document.
Press "{Esc}" and then select function 4 from the main QCONFIG
menu and you should see the following menu:
Output a ^E Auto-Logon Character ...: Y
Use Fast-Logon in Local Mode .......: Y
Clear Screen While Ready for Call ..: Y
The ^E is used for programs like Telix, Procomm, and GT-Powercomm
to start the auto-logon sequences in those programs. This is an
option that will make things easier for some of your users.
The fast-logon will, if enabled, use the first name in the user
file as the person to login from local mode. The user must still
supply the password. This will only work in local mode.
The clear screen while ready for call is used on systems that do
not have continuous mailers. This will clear the screen when no one
is online thus avoiding screen burn.
Message Board Configuration
------- ----- -------------
Select function M from the QCONFIG menu and you should see the
following menu:
Editing Board #:1 [F1]=Change to New Board [F2]=Clear Board [F3]=Print
Name of Board ............:
Type of Message Board ....: 0(0=Standard 1=Net 2=E-Mail 3=EchoMail)
Kinds of Messages ........: 0(0=Both 1=PvtOnly 2=PubOnly 3=ReadOnly)
Combined Mode Access .....: Y Aliases Allowed...........: N
Read Security Level ......: 5
Read A Flags .............: --------
Read B Flags .............: --------
Read C Flags .............: --------
Read D Flags .............: --------
Write Security Level .....: 5
Write A Flags ............: --------
Write B Flags ............: --------
QuickBBS Version 2.00 Documentation - Page 8
Write C Flags ............: --------
Write D Flags ............: --------
Sysop Security Level .....: 100
Sysop A Flags ............: --------
Sysop B Flags ............: --------
Sysop C Flags ............: --------
Sysop D Flags ............: --------
Remember that all messages on all boards are actually contained
in five files. There are NO subdirectories for each area as is the
case with Opus and other file oriented message systems. Each message
board will be referred to by the number that is found on the first
line of this screen.
The name of the message board is what will be used during mail
check to indicate to the user what board has mail. This name is also
used in the message board header on the screen to identify the board.
There are three basic types of boards: Standard, net, and echo.
E-mail is not fully implemented and defaults to standard. A standard
message board in one in which there is no exchange with other boards.
An example of this would be a local message board. A net message
board is used for net mail. There can only be one net mail message
board. The echo message board is used for echo mail. Echo mail is
basically a shared message base. messages entered on one of the
boards in the echo will be seen on all of the other boards that
participate in the echo. There can be up to 200 echo boards.
The kinds of messages allowed on an board are private (accessible
only to the author, adressee, or the sysop) or public (accessible to
anyone). If the board is set read only then only the sysop will be
able to post messages on the board.
If the combined mode access is used to determine if a message
board should be included in the combined mode access. The combined
mode access is fully explained in the section covering MENUEDIT.
Basically what combined mode does is allow a user to scan or read all
or some of the boards for which he/she has access at one time. If
the flag is set off then the board will be excluded from the combined
board search.
Some systems and some echos allow aliases if you set the alias
allowed flag on then users may post with aliases. Under no
circumstance will a user be allowed to post with the name sysop. If
messages are posted using an alias then the user will have to
specifically tell QuickBBS to read messages to the alias name as the
alias is not tied to the user in any way.
The read security level is the minimum level that the user must
have to read messages on the board. The read flags are flags that
must be on to have read access to the message board. (flags are
explained in detail in another section of this document)
QuickBBS Version 2.00 Documentation - Page 9
The write security level is the minimum level that a user must
have to be able to write messages on the board.
The sysop security level is the minimum level that a user must
have to be granted sysop access to a board. Sysops may read private
mail, delete, move or forward messages and post on read only boards.
When you are done setting up one board press the {PgDn} button to
set up the next board. The {PgUp} button will allow you to change
something on the previous board. You can create up to 200 boards.
When you are done press {Esc} to return to the QCONFIG main menu.
Event Editing
----- -------
Editing of Event #1
Status ...................: 0 (0=Deleted 1=Enabled)
Time of Day to Run Event..: 00:00
ERRORLEVEL Value..........: 6
Sunday....................: N
Monday....................: N
Tuesday...................: N
Wednesday.................: N
Thursday..................: N
Friday....................: N
Saturday..................: N
Events are used for non-continuous mail boards. Events may be
used to cause QuickBBS to pack the message base at a prticular time of
day, exit and run a non-continuous mailer, or any other system
operation that you would like to have operate.
The status indicates whether the event is currently enabled and
thus operational.
The time of day to run the event is the time that the event
should run. Remember that QuickBBS uses a 24 hour clock.
The errorlevel value is the value that the errorlevel will be set
to upon exit of QuickBBS. This value can then be tested in a batch
file to determine what action is to be taken.
Each of the days have a flag. If the flag is set on then the
event will run on the day specified at the time specified. If the day
is not on then the event will not run on that day.
A Discussion of Menu Topology
- ---------- -- ---- --------
Other bulletin board programs force you into an operation
oriented topology. That is you can either work with files or messages
QuickBBS Version 2.00 Documentation - Page 10
but not both on the same menu. QuickBBS will allow you to have a
topic based topology as shown in the following diagrams:
Diagram 1 - Operation oriented topology
+--Files----+--File Area 1 (utilities)
| +--File Area 2 (games)
| +--File Area 3 (graphics)
| +--File Area 4 (programing languages)
Main Menu ---|
|
| +--Message Area 1 (sysop messages)
| +--Message Area 2 (local mail)
+--Messages-+--Message Area 3 (graphics)
| +--Message Area 4 (help)
+--Logoff +--Message Area 5 (programing languages)
Diagram 2 - Topic oriented topology
+--File Area 1 (utilities)
+--File Area 2 (games)
+--File Area 3 (graphics)
+--Files-----+--File Area 4 (programing languages)
|
|--Graphics--+--File Area 3 (graphics)
| +--Message Area 3 (graphics)
|
Main Menu ---|--Programming languages--+--File Area 4 (prog.languages)
(Top) | +--Message Area 5 (prog. lang)
|--Message Area 2 (local mail)
|
| +--Message Area 1 (sysop messages)
| +--Message Area 2 (local mail)
+--Messages-+--Message Area 3 (graphics)
| +--Message Area 4 (help)
+--Logoff +--Message Area 5 (programing languages)
Under a topic based topology there can be multiple paths to the
same area. Topic based topologies are easier for the user to
understand. Areas that pertain to each other are found on the same
menus. I include, on my board, the standard file and message areas
that are required in an operation oriented topology.
Under QuickBBS each of the steps in the above diagrams would be a
menu. To make things easier on you I would recommend that you create
the Top menu, and a logoff menu. The logoff menu should allow the
user to go back to the main menu, send a message to you, or logoff.
When you have this much working build a menu to access each of your
message boards and each of your file areas. Then group these menus
under menus until you reach the top menu. A word of advice: Do not
nest your menus too deep; users are accessing your board to get to the
information not to see your pretty menus.
QuickBBS Version 2.00 Documentation - Page 11
If each of your menus has an option to return to the previous
menu (menu type 3), an option to return to the top menu (menu type 1)
and an option to logoff (using type 2 so the user can return to the
current menu); and you always use the same keys (I use '*' to go to
the top, '-' to return to the previous menu, and '!' to logoff) then
your users should find the system easy to use.
Tips on Setting up Menus
---- -- ------- -- -----
Before you start creating menus you should sit down and decide
what your menu structure will look like. Once you have done this you
can create the lowest level menus first. If, for example, you create
a menu to handle all message transactions (i.e. reading, writing,
scanning) then you can use MENUEDIT to create a copy of the menu, make a
few changes, and have menus for two message areas. The same applies
to file areas. Once you have created all of the lowest level menus
create the menus that call those menus. Continue in this manner until
you reach to top menu.
Setting up Menus
------- -- -----
Once you have configured the bulletin board you will need to
create the menus. To do this change to the menus directory and type
"MENUEDIT{Return}" and you will see the following menu:
Menus Already on Disk:
[None]
Enter Menu Name to Create/Edit:
[F1]=Copy [F2]=Delete [F3]=Rename [ESC]=Exit MENUEDIT
The copy command will allow you to copy an existing menu to
another menu name. This will create a duplicate of the first menu
under the second name. You can then edit the second menu. This
allows you to take a message board menu, for example, and by copying
QuickBBS Version 2.00 Documentation - Page 12
and editing make a menu for a second message board.
The delete command will delete menus that you are no longer
using.
The rename function allows you to rename a menu.
Enter the name of the menu that you wish to edit or create. If
the menu does not exist you will be asked if you wish to create it.
You will then see the following menu:
QuickBBS Menu Editor Version 2.00 by Adam Hudson
Menu Name: TOP Entries: 0
[A]dd ......... Add a New Entry to the Menu
[C]hange ...... Change an Existing Menu Entry
[I]nsert ...... Insert Entry Into Menu
[D]elete ...... Delete an Existing Menu Entry
[L]ist ........ List Entries on Menu
[S]imulate .... Simulate Menu with Security Level
[P]rompt ...... Set Menu Prompt and Prompt Colors
[H]ighlight ... Set Highlight Colors for Menu
Press [ESC] to End Editing Menu.
Press Selection:
Selecting the add option will display append entries to the menu.
Changing an existing menu entry will allow you to edit the menu
entries.
Inserting entries will allow you to place an entry into the menu.
Deleting an entry will allow you to remove a menu entry.
Listing the menu entries will allow you to view all of the data
concerning each of the menu entries.
Simulating the menu will allow you to see what the finished menu
will look like. If you simulate a menu, change it, and simulate it
again MenuEdit will remember what the last security level that you
simulated was.
The prompt is the line that appears on the bottom of the menu.
The default prompt is Command:. You can change the prompt line to be
any text line. The default colors are low intensity white on black.
The edit prompt option will allow you to change any of these
attributes.
QuickBBS Version 2.00 Documentation - Page 13
The default highlight color is low intensity white. The
highlight is turned on by placing a caret '^' in the text line. To
turn off the highlight you should place a second caret in the text
line.
When you add, change, or insert menus you will see the following
menu:
Adding Entry
1 2 3 4 5 6
123456789012345678901234567890123456789012345678901234567890123456789
Optional Data:
Type..........: 0
Security......: 1
Key...........: ?
Foreground....: 7
Background....: 0
A Flags.......: --------
B Flags.......: --------
C Flags.......: --------
D Flags.......: --------
[ESC] Exit [F1] Save Entry [F2] Center Display Line
The first line, under the numbers, is the display line. This is
the line that will be displayed on the menu. You build the menus one
line at a time. There are several keys that perform special functions
when included on the display line: the caret '^' highlights the
string, the tilde '~' will display the time remaining, and the semi-
colon ';' will cause the next line to be appended to the current line
begining at the position of the semi-colon.
The optional data will be determined by the type. Basically the
optional data will indicate where and with what special options the
type should be executed.
Type indicates what the menu selection will do. (See Menu Types
and Optional Data for more information)
The Security is the security level that the user must have to see
and select this menu option.
The key is the key the user must press to select the menu option.
The key is not case sensitive.
QuickBBS Version 2.00 Documentation - Page 14
The foreground and background options are to add color to your
menu. (See the color chart for more information on colors)
The flags further restrict access to a menu option. If any of
the flags are set then the user must have those flags set in his/her
user file record to be able to see and access the menu selection.
Each menu may have up to 50 entries.
Menu Types and Optional Data
---- ----- --- -------- ----
Type Description Optional Data
0 .... Text Line (Not Considered a Command) .. None
This is used to display information on the
menu.
1 .... Goto New Menu ......................... <Menu Name> <Password>
This option will jump to another menu
without saving a path back. The menu name
should be a menu created with the MENUEDIT
program. The password is one word, non
case sensitive, and will be required from
the user.
2 .... Gosub New Menu ........................ <Menu Name> <Password>
This option will jump to another menu and
save the path back. This enables the
following option. The menu name should be
a menu created with the MENUEDIT program.
Menus can only be nested 20 levels deep.
After that any subsequent gosub call will
not work and the user will have to return
from the current menu either via a type 1,
3, or 4 option. The password is one word,
non case sensitive, and will be required
from the user.
3 .... Return from Previous Gosub ............ None
Returns to the menu that was last called
with Type 2.
4 .... Clear Gosub Stack and Goto New Menu ... <Menu Name>
Jumps to another menu and deletes the path
back from the last menu called by a type
2.
5 .... Display .ASC/.ANS File ................ <1-8 Character Name>
Displays an ASCII (ASC) or ANSI (ANS) file
in the Custom Text and ANSI file directory
given in the QCONFIG file. You should
only give the file name not the extension
as the users graphics option will
QuickBBS Version 2.00 Documentation - Page 15
determine whether or not the ASC or ANS
file will be displayed. If no ANS file is
found then the ASC file will be displayed.
If graphics mode is off and there is no
ASC but there is an ANS file then nothing
is displayed.
6 .... Selection Menu ....................... <1-7 Character Prefix>
This option displays a file that contains
up to ten text files. When the user enters
a one (1) then the file with the name
XXXXXXX1.ANS or XXXXXXX1.ASC is displayed
where XXXXXXX is the 1-7 character prefix
given in the optional data field. These
files must be found in the directory with
the QuickBBS textfiles.
7 .... Shell Under Board and Run Program .. See Text
This option will load a program to run
while the user is on line. If the program
is an EXE or COM file then you do not need
to use COMMAND.COM you simply put the name
of the program with extension on the
command line along with any command line
parameters as in the following example:
BBSList.EXE *B
If the program is not and EXE or COM file
then you must use the COMMAND.COM /C
option as in the following example:
COMMAND.COM /C TW2.BAT
NOTE: Internal DOS commands (i.e. Delete,
Dir, and Rename) must use the COMMAND.COM
/C option. The program must be able to
detect when the carrier has been lost and
exit. The Command line can consist of
anything you wish, there are some variables
you can use, they are as follows:
*B Passes Baud Rate (300, 1200, 2400
and 0 for Local)
*C Full path to COMMAND.COM as set in
the DOS environment variable
COMSPEC. Therefore the above
COMMAND.COM example could be written
as *C /C TW2.BAT.
*F First Name of User
*G Graphics Mode (Off is 0, 1 is On)
*H Tells QuickBBS to shell with the
fossil hot (Open).
*L Last Name of User
*R Record Number of User for the User
Database
*T Time Left for Call (in minutes)
This command also writes a file called
QuickBBS Version 2.00 Documentation - Page 16
EXITINFO.BBS the structure of which is
contained in the Structures document.
8 .... Version Information ................... None
This menu type simply displays the current
version of QuickBBS being run.
9 .... Logoff the System ..................... None
Log the user off the system. Hangs up the
phone.
10 ... Display System Usage Graph ............ None
Displays a graph of system usage by hour.
11 ... Page the Sysop for Chat ............... Page Prompt
Allows the user to page you for a chat.
Usually the user needs help.
12 ... Execute Questionnaire File ......... <1-8 Character Q-A Name>
Executes a questionnaire file. This file
must be in the same directory as the
QuickBBS programs and have the extension
Q-A. All answers will be placed in a file
with the same name but having the
extension ASW. Each line in a Q-A file is
considered to be a command and must follow
the Questionnaire Command Language fomat
given below. There is one hard coded
questionnaire. This is the NEWUSER.Q-A.
This questionnaire is asked after the
NEWUSER2.A?? file is displayed.
Questionnaire Command Language:
Questionnaire files are read in line by
line, each line is considered to be a
command. The valid commands allowed are:
------------------------------------------
Ask <Len> <Var Num>
Example: Ask 60 3
This command inputs up to <Len>
characters and stores the result in
variable number <Var Num>. The <Len> can
be from 1 to 255.
------------------------------------------
ChangeColor <Foreground> <Background>
Example: ChangeColor 15 1
This command changes the current
QuickBBS Version 2.00 Documentation - Page 17
color if the user has ANSI selected, the
<Foreground> can be from 0 to 15 and the
<Background> can be from 0 to 7.
------------------------------------------
ClearScreen
Example: ClearScreen
This clears the callers screen, but
only if the caller has selected screen
clearing.
------------------------------------------
Display "<String>"
Example: Display "Question #1: What
is your real name?"
This command simply just displays the
character string <String>, remember you
MUST place the quotes around your output
string.
------------------------------------------
Endif
Example: Endif
This command terminates the If
statement (see below)
------------------------------------------
If <Var Num> = "<Test String>"
Example: If 3 = "Adam"
This command does a comparison on a
variable number and the <Test String>.
The test is not case sensitive. If the
comparison is true then the following
questionnaire lines are processed until an
Endif is reached , otherwise all lines
through the Endif are skipped .
NOTE: YOU MUSY HAVE A SPACE BEFORE
AND AFTER THE EQUALS (=) SIGN! ALSO, YOU
MUST END AN IF WITH AN ENDIF STATEMENT.
------------------------------------------
GetChoice <Choices> <Var Num>
Example: GetChoices 12345 3
QuickBBS Version 2.00 Documentation - Page 18
This command inputs one character
which will consist of an item in the
<Choices>. The result is stored in
variable number <Var Num>.
------------------------------------------
OutputAnswer "<Descriptor>" <Var Num>
Example: OutputAnswer "NAME: " 2
This command will output the contents
of <Var Num> to the answer file and label
it with the string <Discriptor>.
------------------------------------------
PostInfo
Example: PostInfo
This command simply posts the user's
information in the answer file. It
includes Name, Calling From, and Time-Date
stamp of entry.
------------------------------------------
Quit
Example: Quit
This command terminates the
questionnaire script and closes the answer
file.
------------------------------------------
SetFlag <Flag Set><Flag Number> <ON|OFF>
Example: SetFlag D5 ON
This command will alter the user's
flag sets, <Flag Set> is A through D, and
<Flag Number> is 1 through 8 and refers to
the left through rightmost flag
respectively. You can either turn a flag
on or off.
------------------------------------------
NOTE: A CR/LF sequence can be placed in
strings within quotes (") by placing a '|'
character in it. This can be used to get
the display command to display to
terminate the line.
NOTE: The reference <Var Num> has the range
QuickBBS Version 2.00 Documentation - Page 19
of 1 to 20. This means you have twenty
variables to work with, each of which can
be up to 255 characters long.
13 ... List/Search User List ................. None
Allows the user to list or search the user
file. This is handy for local mail
options where the user may not remember
the correct spelling of the name of the
person to who they want to send the
message.
14 ... Time Statistics ....................... None
Gives the callers time on line, time
remaining and total time today.
15 ... Exit to DOS ........................... <DOS ERRORLEVEL>
Exits to the batch file that loaded
QuickBBS with the error level set to the
value given by the optional data field.
This errorlevel should be Greater than 5
as errorlevels 0 to 5 are reserved by
QuickBBS. To allow the user back into
QuickBBS you must use the -R command line
option when loading QuickBBS. The
reloading of QuickBBS must be on a
seperate line from the first time that
QuickBBS was invoked as in the following
example:
------------------------------------------
QuickBBS -B%1 -T%3
:finished_QuickBBS
if ERRORLEVEL 6 goto outside
if ERRORLEVEL 5 goto net&echo
if ERRORLEVEL 4 goto echo_only
if ERRORLEVEL 3 goto net_only
if ERRORLEVEL 0 goto finished
:outside
{ do outside stuff here}
QuickBBS -R
goto finished_Quickbbs
------------------------------------------
This command also writes a file called
EXITINFO.TXT the structure of which is
described in the Structures document.
16 ... Change City and State ................. None
Allows the user to change his/her city and
state calling from field.
17 ... Change Password ....................... None
Allows the user to change his/her
QuickBBS Version 2.00 Documentation - Page 20
password.
18 ... Change Length of Screen ............... None
Allows the user to change the length of
his/her screen
19 ... Toggle Screen Clearing ................ None
Turns the screen clearing codes on/off.
20 ... Toggle Page Pausing ................... None
Turns the page pausing on/off
21 ... Toggle Graphics Mode .................. None
Turns the graphics on/off. If the
graphics are on then the the ANSI
equivalent of the ASCII files will be used
where available.
22 ... Check for Personal Mail ............... None
Checks the message base for un-received
personal mail. This is useful if you do
not have the automatic mail checking
turned on in the QCONFIG file, or when the
user did not read his/her mail at logon.
23 ... Read Messages ......................... <Board #>
Starts the message reading routine for the
board number listed in the optional data
field. The board number should be the
number that was assigned to the board when
setting up the message boards in the
QCONFIG program.
24 ... Scan Messages ......................... <Board #>
Starts the message scanning routine for
the board number listed in the optional
data field. The board number should be
the number that was assigned to the board
when setting up the message boards in the
QCONFIG program.
25 ... Quick-Scan Messages ................... <Board #>
Starts the Quick-Scan routine for the board
number listed in the optional data field.
The board number should be the number that
was assigned to the board when setting up
the message boards in the QCONFIG program.
26 ... Delete Selected Messages .............. <Board #>
Deletes messages from the board number
listed in the optional data field. This
board number should be the number that was
assigned to the board when setting up the
message boards in the QCONFIG program.
QuickBBS Version 2.00 Documentation - Page 21
27 ... Post a New Message ......... <Board #> [/L] [/T=<Name>]
Posts a message to the board number listed
in the optional data field. The board
number should be the the number that was
assigned to the board when setting up the
message boards in the QCONFIG program.
The /L option will force a logoff after
the message is written. The /T= option
will force the message to be addressed to
the person specified in the <Name> part of
the specification. The name should be in
the form Firstname_Lastname. (note the
underscore). This is handy to force
messages to the sysop at logoff to be
addressed directly to you.
28 ... Select Combined Boards ................ None
This option allows the user to select/de-
select the boards that he/she would like
to check for mail. The default is All
boards the user has access to. This
option is used in conjunction with the
read, scan, and quick-scan options. You
must set these options to point to board
0. This is a fictitious board. For
example, if a user to wanted to search
combined boards then he/she would execute
a type 28 option and then select the
search option that points to board 0.
29 ... Move A File ........................... <Full Path>
This option will allow you to move a file
from one directory to another. The
function will update the FILES.BBS files
and delete file from the original
directory. The optional field must
contain the path name for the directory
from which the file will be moved. The
path name must be of the form:
Drive:\dir1\dir2\...dirN. This option is
intended for use by sysops on boards that
check uploads before placing them in the
proper directories.
30 ... MS-DOS Directory ...................... <Full Path>
This will display the directory as though
the user had typed "Dir" in the directory
specified in the optional data field. The
optional field must contain a full path
name of the form:
Drive:\dir1\dir2\...dirN.
31 ... List FILES.BBS ........................ <Full Path>
QuickBBS Version 2.00 Documentation - Page 22
This is similar to the above option except
that a file called FILES.BBS is displayed
instead. This file should contain the
names of the files available for download
as well as a description of the files.
The FILES.BBS is created/updated when a
user uploads a file to the directory. The
FILES.BBS MUST NOT END IN A CTRL-Z. If you
edit these files you must be sure that
your editor does not add a Ctrl-Z, or you
should run a program like Strip_Z that
will remove the Ctrl-Z. The optional
field must contain a full path name of the
form: Drive:\dir1\dir2\...dirN.
32 ... Download a File from Sub-Dir .......... <Full Path> <Password>
Allows the user to download a file from
the directory specified in the optional
data field. The file does NOT have to be
in the FILES.BBS file for the user to down
load it. The optional field must contain
a full path name of the form:
Drive:\dir1\dir2\...dirN. The password is
one word, non case sensitive, and will be
required from the user.
33 ... Upload a File to Sub-Dir .............. <Full Path>
Allows the user to upload a file to the
directory specified in the optional data
field. This will create/modify the
FILES.BBS file in the specified directory.
The optional field must contain a full
path name of the form:
Drive:\dir1\dir2\...dirN.
34 ... List Archive in Sub-Dir ............... <Full Path>
Allows the user to view the contents of an
archive file in the directory specified by
the optional data field. The optional
field must contain a full path name of the
form: Drive:\dir1\dir2\...dirN.
35 ... Search for File by Keyword ............ None
Performs a Keyword search in the FILES.BBS
files that are found in the FLSEARCH.CTL
file. Information on this file is found
elsewhere in this document.
36 ... Search for File by FileName ........... None
Performs a file name search in the
FILES.BBS files that are found in the
FLSEARCH.CTL file. Information on this
file is found elsewhere in this document.
QuickBBS Version 2.00 Documentation - Page 23
37 ... List New Files on System .............. None
Performs a search for files that have been
added to the system since a specific date.
The user is prompted for the date. The
default date is the last time the user was
on.
38 ...*Download a Specific file .............. <Full Path and Name>
Downloads the specified file with a protocol
specified by the user. For example if the
optional data field read:
C:\FILES\ARCUTIL\PK53UTIL.EXE
Then the file PK53UTIL.EXE in the
\FILES\ARCUTIL directory on the C drive
would be downloaded using a protocol
specified by the user.
39 ... Display a Direct Text File ............ <Full Path and Name>
This is similar to the display ASC/ANS
file option above except that any file
anywhere on the system may be displayed.
The file may contain the special control
characters found elsewhere in this
document. The optional field must contain
a full path name, file name and extension
of the form:
Drive:\dir1\dir2\...dirN\filename.ext.
40 ... Display .ASC/.ANS File -w- Hot Keys ... <1-8 Character Name>
This command is similar to the type 5
command except that the menu hot keys are
active while the file is being displayed.
This allows you to create special graphics
menus and still have the hot keys
operational.
41 ... Toggle Full Screen Editor ............. <None>
Toggles the use of the full screen editor.
Options marked with an asterisk are not yet implemented.
Automatic Execution from Menu
--------- --------- ---- ----
***** WARNING ***** THIS OPTION IS NOT FOR THE NOVICE. DO NOT
USE IT UNLESS YOU KNOW WHAT YOU ARE DOING. If you use a ^A
({Ctrl}{A}) for the key to activate the menu option that option will
automatically be executed when it is encountered. This will allow you
to create custom menu screens with ANSI displays. Note that if you
place your menu options in the display then the 'hot' keys will not
work unless you use the type 40 command. If you wish to do this then
you should start the display line of each of the menu options with a
QuickBBS Version 2.00 Documentation - Page 24
semi-colon ';' so that the display line will be ignored.
Example of Building Menus
------- -- -------- -----
Although it is beyond the scope of this manual to give examples
of all the possible combinations of menu structures, examples of the
most common structures have been included. In each of the examples it
is assumed that you are starting at the MENUEDIT opening screen.
The name of this menu will be Msg1. Type the word "Msg1" as the
name of the menu to create/edit and press {Enter}. Press 'Y' when the
program asks if you want to create the menu. You should now see the
menu editing menu. The menu name should be listed as MSG1. Press the
'A' key to begin adding to the menu.
The first line on the menu will be the menu name. We will call
this menu: Message Board 1 Access Menu. Type this on the first line
of the adding entry screen and press {Enter}. We want this menu line
to be in high intensity white so press {Enter} until you are on the
line that says: Foreground. Replace the 7 with the number 15. Press
{Enter} and then press {F1} to save this line.
The second line of the menu will be blank so just press {F1}
The third line of the menu will be the selection to read the
messages. For this option we will use the 'R' key to activate it and
The text will be green. We will allow anyone with a security level of
1 or higher to read public messages. Type: '<R> Read Messages' and
press {Enter}. On the optional data line type '1' and press {Enter}
this indicates that we will be reading the messages on message board 1
as defined in the QCONFIG program. On the type line enter the number
27. This indicates that this menu option will read from the message
board listed on the optional data line. Leave the security level set
as 1. For the key field enter an 'R'. In the foreground field enter
the number 10; this changes the color to green. Press the {F1} key
when you have finished this.
The fourth line of the menu will be the selection to scan the
messages. For this option we will use the 'S' key. On the first line
type: '<S> Scan Messages' and press {Enter}. On the second line
enter the number 1. In the type field enter the number 24. For the
key field enter a 'S'. In the Foreground field enter then number 10.
Press the {F1} key when you have finished this.
The fifth line of the menu will be the selection to Quick-Scan
the messages. For this option we will use the 'Q' key. On the first
line type: '<Q> Quick-Scan Messages' and press {Enter}. On the
second line enter the number 1. In the type field enter the number
25. Fro the key filed enter a 'Q'. In the foreground field enter the
number 10. Press the {F1} key when you have finished this.
The sixth line of the menu will be the selection to Write
messages. This option will use the 'W' key but will be restricted to
QuickBBS Version 2.00 Documentation - Page 25
users that have a security level of 10 or higher. On the first line
type: '<W> Write Messages' and press {Enter}. On the second line
enter the number 1. In the type field enter the number 27. In the
security field enter the number 10. in the key field enter a 'W'. In
the foreground field enter the number 10. Press the {F1} key when you
have finished.
The seventh line will be blank so press the {F1} key again.
The eighth line will be the line that takes the user back to the
previous menu. This menu option will be in red and we will use a '-'
to activate it. On the first line type: '<-> Previous Menu' and
press {Enter}. The second line should be left blank. The type field
should be set to 3. In the key field type a '-'. The foreground
color should be set to 4 (red). Press {F1} when you have finished
this.
The ninth line of the menu will be the option that takes the user
back to the top menu. We will use the '*' key to activate this
option. The first line should read: '<*> Top Menu'. On the second
line you should type 'TOP' and press {Enter}. The type should be set
to 4. The key field should contain the '*' character. The foreground
should be set to 4. Press {F1} when you have finished this.
The tenth and last menu option will be the logoff option. For
this selection we will use the '!'. The first line should read: '<!>
Logoff'. On the second line type the word 'Logoff'. The type field
should be set to 2. The key field should contain a '!'. The
foreground field should be set to 4. Press {F1} when you have
finished this.
To finish editing the menu press {Esc}. If you now press 'S' to
simulate the menu and give it a security level of 10 you should see
the following menu displayed:
Message Board 1 Access Menu
<R> Read Messages
<S> Scan Messages
<Q> Quick-Scan Messages
<W> Write Messages
<-> Previous Menu
<*> Top Menu
<!> Logoff
Command:
Press any key to get back to the edit menu screen. If you now
simulate the menu at a security level less than 10 you will see the
same thing except that the write option will not be displayed.
Press escape to get back to the MENUEDIT opening screen.
QuickBBS Version 2.00 Documentation - Page 26
The Logoff menu was called in the previous example from the tenth
line. This example will show how to build the logoff menu. Enter the
word 'Logoff' as the name of the menu to create/edit. Answer yes when
you are asked if you want to create it and the menu edit screen should
be displayed. Press 'A' to begin adding to the menu.
The first line of the menu will be: 'System Logoff Menu' so type
this on the first line and press {F1}.
The second line will be blank so press {F1}.
The third line will allow the user to send a message to you at
logoff. This message will be placed in message area 1. The user will
be logged off after the message is posted. The color of the menu
option will be green. On the first line type: '<L> Leave A Note To
The Sysop' and press {Enter}. On the second line type: '1 /L
/T=Your_Name' and press {Enter}. (Note: replace the Your_Name with
the name you will use on the bulletin board in the previous line).
The type field should be set to 27. The key field should contain an
'L'. The foreground color should be set to 10.
The fourth line will allow the user to return to the previous
menu and will be red. This should be the same line eight in the
message board menu.
The fifth line will allow the user to return to the top menu and
should be the same as line nine in the message board menu.
The sixth line will really log the user off. This line will use
the '!' to activate the option. On the first line type: '<!> Logoff'
and press {Enter}. The second line should be blank. The Type should
be set to 9. The key field contain the '!' and the foreground should
be set to 4.
When you have finished all of the entries press escape to return
to the menu edit screen. If you simulate the menu you should see
something like this:
System Logoff Menu
<L> Leave A Note To The Sysop
<-> Previous Menu
<*> Top Menu
<!> Logoff
Command:
The name of this menu will be File1. Type the word "File1" as
the name of the menu to create/edit and press {Enter}. Press 'Y' when
the program asks if you want to create the menu. You should now see
the menu editing menu. The menu name should be listed as FILE1.
Press the 'A' key to begin adding to the menu.
The first line on the menu will be the menu name. We will call
QuickBBS Version 2.00 Documentation - Page 27
this menu: File Area 1 Access Menu. Type this on the first line of
the adding entry screen and press {Enter}. We want this menu line to
be in high intensity white so press {Enter} until you are on the line
that says: Foreground. Replace the 7 with the number 15. Press
{Enter} and then press {F1} to save this line.
The second line of the menu will be blank so just press {F1}
The third line of the menu will allow the user to list the files
available for download. We will use the 'F' key to activate this and
the option will appear in green. On the first line enter: '<F> Files
Available For Download' and press {Enter}. On the second line enter
the full path to the file area. In this example we will use:
'C:\Files\Area1'. The type should be set to 31. The key field should
contain a 'F' and the foreground should be set to 10. Press {F1} to
save this line.
The fourth line will allow the sysop to see a DOS directory of
the area. On the first line enter: '<L> List Files - DOS Directory'.
On the second line enter: 'C:\Files\Area1'. The type should be set
to 30, the security to 100, and the key to 'L'. The foreground color
should be set to 6 (brown). Press {F1} to save this entry.
The fifth line will display the files in an archived file. On
the first line enter: '<C> Contents Of An Archive'. On the second
line enter: 'C:\Files\Area1'. The type should be set to 34, key to
'C', and the foreground color to 10. Press {F1} when this is done.
The sixth line will allow the user to download a file. On the
first line enter: '<D> Download A File'. On the second line enter:
'C:\Files\Area1'. The type should be set to 32, the key to 'D' and
the foreground color to 10. Press {F1} when this is done.
The seventh line will allow the user to upload a file. This file
will be stored in the C:\Files\Area1 directory although it is possible
to force uploads into a separate directory so that the sysop can check
them out before another user downloads them. On the first line enter:
'<U> Upload A File'. On the second line enter: 'C:\Files\Area1'.
The type should be set to 33, the key to 'U' and the foreground color
to 10. Press {F1} when this is done.
The eighth line will be blank so press {F1}.
The ninth line will allow the user to search for files by
keyword. This assumes that you have a FLSEARCH.CTL file set up. On
the first line type: '<K> Locate File By Keyword'. The second line
should be blank. The type should be set to 35, the key to 'K', and
the foreground color to 6 (brown). Press {F1} when this is done.
The tenth line will allow the user to search for files by file
name. This also assumes that you have a FLSEARCH.CTL file set up. On
the first line type: '<N> Locate File By Name'. The second line
should be left blank. The type should be set to 36, the key to 'N'
and th foreground color to 6 (brown). Press {F1} when this is done.
QuickBBS Version 2.00 Documentation - Page 28
The eleventh line should be blank so press {F1}.
The twelfth line should be the same as the eighth line in the
message menu example above.
The thirteenth line should be the same as the ninth line in the
message menu example above.
The fourteenth line should be the same as the tenth line in the
message menu example above.
Press {Esc} to return to the menu edit screen. Then simulate the
menu with a security level of 100 and you should see the following:
File Area 1 Access Menu
<F> Files Available For Download
<L> List Files - DOS Directory
<C> Contents Of An Archive
<D> Download A File
<U> Upload A File
<K> Locate File By Keyword
<N> Locate File By Name
<-> Previous Menu
<*> Top Menu
<!> Logoff
Command:
If you simulate the menu at any security level less than 100 then you
will not see the 'List Files ..." line. Press Escape to return to the
opening MENUEDIT screen.
The Top menu is the menu that will be shown when the user first
logs on. To create this menu type "TOP" as the name of the menu to
create/edit and press {Enter}. Press 'Y' when the program asks if you
want to create the menu. You should now see the menu editing menu.
The menu name should be listed as TOP. Press the 'A' key to begin
adding to the menu.
The first line of the menu should say 'System Top Menu' so type
this on the first line, change the foreground color to 15, and press
the {F1} key.
The second line should be left blank so press {F1}.
The third line will allow the user to access the message board.
To do this we make a "gosub" call to the MSG1 menu. On the first line
enter: '<M> Message Area 1'. On the second line type: 'MSG1'. The
type should be set to 2, the key to 'M' and the foreground to 10
(green).
QuickBBS Version 2.00 Documentation - Page 29
The fourth line will allow the user to access the file area.
This is done via a "gosub" call to the FILE1 menu. On the first line
type: '<F> File Area 1'. On the second line type: 'FILE1'. The
type should be set to 2, the key to 'F' and the foreground to 10.
The fifth line will allow the user to logoff. On the first line
type: '<!> Logoff'. On the second line type: 'Logoff'. The type
should be set to 2, the key to '!' and the foreground to 4 (red).
Press {Esc} to finish entering this menu and simulate it. It
should look like:
System Top Menu
<M> Message Area 1
<F> File Area 1
<!> Logoff
Command:
You now have a small but functional QuickBBS menu structure. You
can build upon this structure to achieve any type of board that you
wish. The above examples in no way are a complete set of the all the
types of menus that can be created in QuickBBS. In fact they are a
minimumal set.
Once you have the four example menus set up and working to your
satisfaction you can create other menus that are identical in
structure. Make sure that the colors are the way you want them. That
the highlights are colors that you want. And that the menus generally
reflect the way you want the board to work.
To create a second message base menu select the copy option {F1}
from the MENUEDIT opening screen and copy the MSG1 menu to MSG2. Then
edit MSG2. Change the first line to read 'Message Area 2 Menu' and
the 1's on the optional data lines in menu lines three through six to
2's. Add a line in the Top menu that calls MSG2 and you are done,
provided you have set up the second message board using QCONFIG.
To create a second file area menu select the copy option {F1}
from the MENUEDIT opening screen and copy the FILE1 menu to FILE2.
Then edit FILE2. Change the first line to read 'File Area 2 Menu' and
change the C:\Files\Area1 to C:\Files\Area2 on the optional data lines
in menu lines three through seven. Add a line to the Top menu that
calls FILE2 and you are done, provided you have a C:\Files\Area2
directory.
Getting Yourself into the User File
------- -------- ---- --- ---- ----
You should now start the QuickBBS program by typing "QUICKBBS -
L{Enter}" If you have set up all of the files correctly the bulletin
board will load and start by asking you for your name. You should log
QuickBBS Version 2.00 Documentation - Page 30
in the way you normally would. Then exit the bulletin board. This
will create the USER.BBS file. This file contains all of the data
about the users of the system. Once you have logged into your board
you should logoff and edit your entry in the user file.
Editing the User File
------- --- ---- ----
To edit the user file make sure that you are in the directory
that contains the QuickBBS programs and then type "Useredit{Enter}".
The program will allow you to change any of the users attributes.
When the user is firs entered the NO-KILL and IGNORE flags are not
visible. They are included in the display below so that you will know
where they will be displayed on the screen.
QuickBBS User Editor Version 1.00 by Adam Hudson
[ 0 of 1 ]
Name: New User (NO-KILL) (IGNORE) (ED)
City, State: Nowhere, USA
Password: New Bus/Data: None Home/Voice: None
ANSI Mode: Y Screen Clearing: Y "More <Y/N>?" Prompt: Y
A Flags:-------- B Flags:-------- C Flags:-------- D Flags:--------
Credit: 0 cents Security Level: 0 Screen Length: 25 lines
Times Called: 0 Times Posted: 0 High Msg Read: 0
Pending: 0 Uploads: 0 Upload K-bytes: 0
Downloads: 0 Download K-Bytes: 0 Time Used: 0
K-Bytes Used: 0 Last Called: 01-01-80 00:00
F1-Help F2-Edit User F3-Delete User F4-Print User F5-Find User
F6-Search F7-Clear Lmts F8-Add a User F9-Record # F10-Exit UEDIT
To set the user flags place the cursor on the flag that you want
to change and press the 'x' key.
The net mail credit is the amount of credit you will give a user
to send long distance mail. This is mail that will cost you to send.
Most sysops require a deposit by the user for this privilege. You may
want to give yourself credit or you won't be able to send long
distance mail. Credit is entered in the lowest denomination for the
country in which you are operating.
The security level may be set to any value from 0 to 32000.
Users with a security level of 0 will not have access to the board.
You should edit your record so that you have the sysop security level
as defined in the QCONFIG file.
The times called is the number of times the user has called the
QuickBBS Version 2.00 Documentation - Page 31
system.
The times posted is the number of messages the user has posted to
the system.
The high msg read is the highest number message that the user has
read.
The pending field lists the cost of all net mail messages that a
user has entered but that have not been exported.
The uploads field lists the number of files the user has
uploaded. The upload K-bytes lists the number of kilobytes that the
user has uploaded.
The downloads lists the number of files downloaded, and the
download kilobytes list s the number of kilobytes that the user had
downloaded.
K-Bytes used lists the difference between the uploads and
downloads. If this value is negative then the user has downloaded
more Kilobytes then he/she has uploaded.
Last called is the date and time that the user last called.
If you press the {F1} key you will see the following menu:
F1 This Help Window
F2 Edit Current User's Parameters
F3 Delete Current User Toggle
F4 Print Current User's Parameters
F5 Find a User
F6 Search for a User
F7 Clear Time and Download Limit
F8 Add a New User to Database
F9 Goto Specific Record Number
F10 Exit Program
Home First User in Database
End Last User in Databse
PgDn Next User in Database
PgUp Previous User in Database
Alt-I Toggles Ignore Download Hours Flag
Alt-N Toggles No-Kill Flag
Alt-E Toggles Full Screen Editor
Alt-F Global Flag Change
Press any key to continue ...
Pressing {F2} will allow you to edit the user record. The field
currently being edited will be extended with blocks the left arrow (4
on the numeric pad) and the right arrow (6 on the numeric pad) will
move you from one field to the next. When you are finished editing a
record press {ESC}.
QuickBBS Version 2.00 Documentation - Page 32
Pressing {F3} will mark or un-mark a user for deletion.
Pressing {F4} will print the current user record.
Pressing {F5} will allow you to find a specific user in the file.
Pressing {F6} will search for a user if you only remember a
partial name. This differes from {F4} as with {F4} you must know the
users name.
Pressing {F7} will clear the times called through K-Bytes used
fields.
Pressing {F8} will add a new user to the end of the user file.
The information for the user will be as listed in the example of the
USEREDIT screen above.
Pressing {F9} will prompt you for a record number. Once entered
the USEREDIT program will go to that record number and display it.
You may then edit the record with the {F2} key or perform any of the
other record specific functions listed here.
Pressing {F10} will exit the USEREDIT program.
To mark a user as having the ability to download when downloading
is not allowed as specified in the QCONFIG program press {ALT}I. This
will turn on or off the ignore download hours flag.
If a user is marked as No-Kill then he/she will not
automatically be deleted regardless of how long it has been since
they loged on the system. (See USERPACK documentation for
information on deleting users) To mark a user as No-Kill press the
{Alt}N. This will turn the No-Kill flag on or off.
If a user record has the 'ED' field on then that user will be
using the external full screen editor. Full screen editors are
separate packages from QuickBBS and can be found on most QuickBBS
boards. To mark a user as using the full screen editor press {Alt}E.
This will turn the full screen editor on or off. The user may also
change the full screen toggle by executing a type 41 command. (See
MENUEDIT documentation for more information on this option).
You can reset a specific flag for all users in the user file.
This is done by pressing {Alt}F. You will be prompted for the flag
set, 'A' through 'D', and then for the number of the flag within the
set. Flags are numbered from 1 to 8, left to right. You will then be
asked if you want to turn the flag on or off. The program will then
change the flag in all user records to match the setting you
specified.
Packing the User File
------- --- ---- ----
QuickBBS Version 2.00 Documentation - Page 33
The program USERPACK will remove all deleted users from the
system. This program has 2 command line options.
-B This option will delete the backup file that is created when
the Userpack program is run.
-D<#> This option will delete users that have not logged on in the
last # days unless the No-Kill flag is set in the users
record Note: There is no space between the -D and the
number.
Example:
Userpack -B -D30
Sorting the User File
------- --- ---- ----
The progam USERSORT will sort the user database by security level
and name. This program will create a backup file before sorting. To
kill this file when the sort is completed add a -B to the command
line.
Cleaning the Message File
-------- --- ------- ----
The Msgutils program will perform several functions on the
message base. The Msgutils program has as a first parameter the
operation that you wish to perform followed by parameters specific to
the operation. This program will mark the messages for deletion, move
them or change the To field but will not remove deleted messages from
the file. To remove the deleted records you will have to run Msgpack.
The operations, parameters and functions are:
Operation Parameters Function
KILLCNT <Board Numbers> -N<Number> Retains the last <Number>
messages in a message board
and kills the rest.
KILLOLD <Board Numbers> -D<Days> Kills messages on the board
numbers listed that are
older than <Days> old.
Note: there is no space
between the -D and the
number.
KILLRECV <Board Numbers> Kills received messages in
boards listed.
DELBRD <Board Numbers> Deletes all messages on the
boards listed.
MOVEBRD <Board Numbers> -T<Target> Moves all messages on the
boards listed to the board
listed in the target field.
QuickBBS Version 2.00 Documentation - Page 34
Note: there is no space
between the -T and the
number.
PRINTBRD <Board Numbers> Prints all of the messages
on the boards listed.
TOALL <Board Numbers> Makes all messages on the
boards listed addressed to
all.
Examples:
----------------------------------------------------------------------
Msgutils KillCnt 5 -N200 Retains the last 200 messages
on board 5 and kill the rest.
Msgutils KillOld 1 2 3 -D10 Kill messages over 30 days old
in message areas 1, 2, and 3.
Msgutils KillRecv 1 2 Kill received messages in
message areas 1 and 2.
Msgutils DelBrd 4 Delete all messages on board
4.
Msgutils MoveBrd 5 6 -T4 Move all messages on boards 5
and 6 to board 4.
Msgutils PrintBrd 4 Print all messages on board 4.
Msgutils ToAll 6 Changes the To field for all
messages on board 6 to ALL.
Packing the Message File
------- --- ------- ----
The program Msgpack will pack the message base. This will delete
the messages that are marked for deletion. This program writes a new
set of files that can be as large as the original files unless the -W
option is used. MSGPACK has five command line options. They are:
-A Analyze. This option will make sure that there is enough disk
space before continuing with the message pack. it is a good idea
to use this option on systems with limited disk space available.
-B Delete Backup. This option will delete the backup message files
when processing is completed.
-R Re-number. This option will re-number the messages while it
removes deleted records.
-I Index. This option will rebuild the message base index. This is
used in cases where the index has been corrupted by a power
failure or other catastrophic problem.
QuickBBS Version 2.00 Documentation - Page 35
-W Write in Place. This option will force MSGPACK to compress the
message files without writing backups. Although this will save
space on systems with limited free disk space there is a very
real danger of message base corruption if the operation is
interupted in any way. This option will be used as a fall back
if the -A option is used. This means that Write-In-Place will
only be used if there is not enough space for the normal message
pack to run.
Example:
Msgpack -A -B -R
Bringing the Board On Line
-------- --- ----- -- ----
To bring the board on line make sure that you are in the
directory that contains the QuickBBS programs and type
"Quickbbs{Enter}" . QuickBBS will then load and run. Stop the
program type press the {Esc} button. To log into the system while it
is waiting for a caller press the 'L' key.
Keys that Work While A user is on line
---- ---- ---- ----- - ---- -- -- ----
Key Use
--- ---
Alt-C Begin Chat mode. This will allow you
to talk (type) to the user that is
currently on line. Press "{Esc}" to
end the chat mode.
Alt-D Display toggle, This is for multi-
tasking environments where you may not
want to see what the user is doing.
Alt-D will turn the display on or off.
Alt-F Change the users flags. This is used
to change any of the 4 privilege flags
for the user.
Alt-H Hang up now! Disconnects the user.
Alt-J Jump to DOS. This will allow you to
jump to DOS while the user is on line
to perform some task. Type Exit to
return to QuickBBS.
Alt-L Lockout the user. This will logoff
the user like Alt-H but in addition
will change the users security level
to 0 so that he/she will not have
access to the board any longer.
Alt-P Log to the printer. This will toggle
QuickBBS Version 2.00 Documentation - Page 36
the printer log swich. This causees
the System.Log file to be sent to the
printer. If the printer is not online
then the flag is reset to off. This
can also be done from a command line
parameter.
Alt-S Change the security level of the user
currently on line. The current
security level will be displayed and
you will be able to type in a new
level for the user.
the up arrow Increases the users time limit by 1
minute.
the down arrow Decreases the users time limit by 1
minute.
Home Displays a help menu locally
End Removes any windows and returns to the
normal screen.
PgDn Display extra stats on the user.
All other keys All other keys work as though the user
pressed them. This means that you can
answer a page, by chatting with the
user, and them help him/her through
the menus by pressing the appropriate
keys.
The Flags
--- -----
Each of the flags controls access to an area. If you set the
first part of flag A on so that it looks like X------- in a menu
selection than only those users that have that flag on in their
USER.BBS record will be able to access the area. This is independent
of the security level required for the menu option. For example if
you restrict access to an area to those with a security level of 20
or higher and Flag A1 set and you have three users:
Name Security Level Flag A
John Smith 10 X-------
Mark Jones 20 --------
Sally Doe 20 X-------
Then only Sally Doe will be able to access the area. John Smith does
not have a high enough security level, and Mark Jones doesn't have
Flag A1 set.
To set a flag in the user file use Useredit. Locate the user you
QuickBBS Version 2.00 Documentation - Page 37
want to set the flag for, press {F2} to edit the user and type an 'X'
on the flag position that you want to set on, or a '-' on the flag
position you want to set off.
To set a flag for message board access use the QCONFIG Message
Board Configuration program. You set or reset the flags as you would
in the user file.
To set a flag for a menu option use Uedit to edit the menu that
you want to change. You set or reset the flags as you would in the
user file.
Colors
------
QuickBBS allows you to set the colors that will be used when
displaying the menus. The colors are set by placing the proper color
code number in the foreground or background color option in the Medit
program. To change the colors on a menu use Medit to load the menu
and change the color fields. The color codes are:
Dark Colors Light Colors
Code Color Code Color
0 Black 8 Dark Gray
1 Blue 9 Light Blue
2 Green 10 Light Green
3 Cyan 11 Light Cyan
4 Red 12 Light Red
5 Magenta 13 Light Magenta
6 Brown 14 Yellow
7 Light Gray 15 White
Background colors may only be Dark Colors, foreground colors may
be any color. Please note that on monochrome screens colors are
displayed as intensities, on some screens it is not possible to
display intensity. In this case light and dark colors will appear the
same. You should also be aware that on some systems the blue colors
will appear underlined. As a general rule do not display dark colors
on dark colors or light colors on light colors. This should make it
possible for all users to see your menus.
Error Handling in QuickBBS
----- -------- -- --------
QuickBBS keeps a log of all errors that are generated by the
QuickBBS program. This log does not include errors encountered while
running any of the external programs. This log file is called
ERRORS.LOG.
Reseting the System Usage Graph
-------- --- ------ ----- -----
The file TIMELOG.BBS contains all of the information used to
create the system usage graph. If for any reason you wish to reset
this graph then you simply erase the TIMELOG.BBS file.
QuickBBS Version 2.00 Documentation - Page 38
Reseting the Number of Callers Counter
-------- --- ------ -- ------- -------
The current number of callers to your system is contained in the
SYSINFO.BBS file. As this file is created and maintained by QuickBBS
you need to run a small utility to change the number of callers. This
utility is called SETNUM. To change the number type SETNUM <n> where
<n> is the number of callers that you wish the system to have
currently recorded.
Setting up the External Support Files
------- -- --- -------- ------- -----
QuickBBS uses 25 external files, some of which are optional.
Five of these files should be placed in the directory with the
QuickBBS program. They are: ECHORIG.CTL, FLSEARCH.CTL, LIMITS.CTL,
PHONENUM.CTL and TRASHCAN.CTL.
The remaining files should go in the custom text and ansi files
path specified in the QCONFIG file. Most of these files are optional
and have two flavors, ASC (ASCII, text) and ANS (ANSI, graphics).
ECHOORIG.CTL contains the origin lines for each echo. This is an
optional file. If it is not found or an origin line for a particular
echo is not found then QuickBBS will use the origin line specified in
QCONFIG. The format of this file is: <Board #> <Origin Line>. The
<Board #> is the number of the board as defined in the QCONFIG
program. The <Origin Line> is a line of text not more than 60
characters in length. If more than 60 characters are specified then
QuickBBS will truncate the line. An example is:
---------------------------------------------------------------------
34 QuickBBS Support Board, (303)423-3114, 1200 Only
45 Quicker than WOC'n!! QuickBBS Support Board
---------------------------------------------------------------------
In this example message boards 34 and 45 have origin lines that are
different from the default.
FLSEARCH.CTL contains the full path name, security level, and
description used for the search for file by keyword and search for
file by name menu options. This file is only required if you use the
search by keyword or search by name procedures. An example of this
file is:
---------------------------------------------------------------------
C:\FILE\COMM 5 Communications_Software
C:\FILE\FIDOUTIL 5 Fido/Opus/SEAdog/QuickBBS_Utilities
C:\FILE\SYSOPFLS 100 Sysop_Files
---------------------------------------------------------------------
QuickBBS Version 2.00 Documentation - Page 39
This example would allow any user with a security level of 5 or more
to search the communications software and fido/opus/seadog/qbbs
utilities directories, but only users with a security level of 100 or
more would be able to search the sysop files directory. NOTE THE
UNDERSCORE. The underscore is used to separate the words that
describe the directory. All underscores are converted to spaces.
NOTE: ALL DATA ITEMS IN *.CTL FILES CAN BE SPREAD OUT INTO EVEN
COLUMNS.
The LIMITS.CTL file determines the time limit and download limit
for the security levels. The file has the following format:
<Security Level> <Time Allowed per Day> <Download Limit (in
kilobytes)>
or <Security Level> <Time> <Download Limit 300> <Download 1200>
<Download 2400>
For example if the LIMITS.CTL file contained:
---------------------------------------------------------------------
5 45 200
10 60 400
100 200 1024
---------------------------------------------------------------------
Then security level 5 would be allowed 45 minutes per day and 200K in
downloads, security level 10 would be allowed 60 minutes per day and
400K in downloads, security level 100 would be allowed 200 minutes per
day and 1024K in downloads.
Another Example of the Second Format for LIMITS.CTL is:
---------------------------------------------------------------------
5 45 200 400 800
10 60 400 500 600
100 200 1024
---------------------------------------------------------------------
Then security level 5 would be allowed 45 minutes per day, 200K in
downloads at 300 baud, 400K at 1200 Baud, and 800K at 2400 Baud.
Security Level 10 would be allowed 60 minutes per day, 400K in
downloads at 300 baud, 500K at 1200 Baud, and 600K at 2400 Baud.
You can specify phone numbers that you know to be bad or
unacceptable. To do this you place the phone numbers in an ascii file
in the format xxx-xxx-xxxx. QuickBBS will scan the phone numbers in
the list against the phone numbers entered. If a bad number is found
then the user is not allowed on the system. You may enter partial
phone numbers. In such a case if the partial number matches the first
digits of the entered phone number then it is considered to be bad.
For example if the PHONENUM.CTL file contained:
---------------------------------------------------------------------
QuickBBS Version 2.00 Documentation - Page 40
303-976
303-555-1212
719-555-1212
605
---------------------------------------------------------------------
Then a user could not enter a phone number that began with 303-976 or
was in area code 605. Nor could the user enter information for
areacode 719 or 303.
The TRASHCAN.CTL file contains a list of names that are not
acceptable on the system. This is an optional file. Each line
contains a first name, last name, or both. For example if the
TRASHCAN.CTL file contained:
---------------------------------------------------------------------
Dr.
Hacker
Mad
Sysop
John Doe
---------------------------------------------------------------------
Then a user could not logon with a name that contained the words: Dr.,
Hacker, Mad, or Sysop as a first or last name. Nor could they log on
with the name John Doe.
DNLDHRS.A?? is the file that is displayed if the user attempts to
download a file during hours that downloading is not allowed as
specified in the QCONFIG program.
EDITHELP.A?? is the file that is displayed if the user selects
help from the message editor. This file should explain what each of
the editor options do. An ASC version of this file is included in
this package.
GOODBYE.A?? is the file that is displayed when the user logs off.
This is the last thing that the user will see from your board.
LOGO.ASC is the file that is displayed just before the system
asks for the callers name. This should be a short file that
identifies your system. This file does NOT have an ANSI flavor. The
system doesn't know whether or not the user can use graphics until it
knows who the user is.
MAXPAGE.A?? is the file that is displayed if the caller attempts
to page more times than is allowed. The number of pages allowed is
specified in the QCONFIG program.
NEWS.A?? is the files that is displayed after the Newuser2 or
Welcome file and after the system checks for mail if you have
instructed it to do so at logon in the QCONFIG program. This should
contain any announcements that you want all users to see.
QuickBBS Version 2.00 Documentation - Page 41
NEWUSER1.ASC is the file that is displayed after the user has
verified that he/she typed his/her name correctly but before any of
the questions specified in the QCONFIG program are asked. This file
does NOT have an ANSI flavor.
NEWUSER2.A?? is the file that is displayed after the user has
selected a password. This file might contain information about your
system that would be of interest to a first time caller.
NO300.ASC is the file that is displayed if a user attempts to
call in when 300 baud is not allowed. The user is logged off after
this file is displayed. This file does not have an ANSI flavor.
NOTAVAIL.A?? is the file that is displayed if the sysop is paged
and the page option is not allowed. The times that paging is allowed
are set in the QCONFIG program.
NOTFOUND.ASC is the file that is displayed if the system can not
find the users name but before the system asks if the caller typed
his/her name correctly. This file might be used to tell the caller
what names are not allowed on the system. This file does NOT have an
ANSI flavor.
PAGEABRT.A?? is the file that is displayed if the sysop aborted
the page.
PAGED.A?? is the file that is displayed after the page has been
made but before the sysop answers. This should probably say something
like please continue using this board, the sysop will break in.
PASSWORD.A?? is the file that is displayed before the system asks
the user for the password he/she will use on the system. This, and
all that follow, may be either ASC or ANS files.
PRIVATE.ASC is the file that is displayed if the system is a
private system and a non-registered user attempts to call in. The
system will log the user off after displaying this message. This file
does not have an ANSI flavor.
READHELP.A?? is the file that is displayed if the user selects
help from the read/scan/quick-scan options. This file should explain
what each of the options do. An ASC version of this file is included
in the package.
SEC#.A?? is a file that is displayed to each security level. The
number sign '#' should be replaced with the security level that is to
view the file. The valid security levels run from 1 to 32000. So
SEC10.ASC would be an ASCII file that would be displayed to users that
have a security level of 10. This file is displayed after the
WELCOME.A?? but before checking for mail.
TIMEWARN.A?? is the file that is displayed when the users time
limit has been adjusted because of an upcoming system event. There is
a default warning if you do not create this file.
QuickBBS Version 2.00 Documentation - Page 42
TOOSLOW.ASC is the file that is displayed if the user attempts to
log onto the system with a modem that is too slow as defined in the
QCONFIG program. The system will then log the user off. This file
does not have an ANSI flavor
TRASHCAN.ASC is the file that is displayed if the system finds
that the users name is in the TRASHCAN.CTL file described above.
After displaying this file the system will log the user off. This
file does not have an ANSI flavor.
WELCOME.A?? is the file that is displayed to callers that have
logged onto your system before. This might be a more elaborate
opening screen then your LOGO.ASC file. This is where you might want
to get extravagant.
XFERHELP.A?? is the file that is displayed when a user requests
help with the file transfer functions. This file should explain what
each of the protocalls do and how they work. An ASC version of this
file is included in this package.
ASC/ANS File Control Characters
------- ---- ------- ----------
The "ASCII" column indicates the ASCII value of the control
character in column "Char". The ^ indicates that it is a control
character. In the "Function" column you will find a brief description
of what each corresponding Control Character does. By placing these
Control Characters in your Text files, you can cause these functions
to happen once the Control Character is reached within the text file.
ASCII #s Char Function
-------- ---- ----------------------------------------------------
001 ^A Pause and Wait for the ENTER key to be pressed
002 ^B Turn <S>top Aborting Off
003 ^C Turn <S>top Aborting On
004 ^D Turn More Prompts On
005 ^E Turn More Prompts Off
006 ^F Combination Command (User Parameters)
007 ^G Ring Caller's Bell
008 ^H Backspace
009 ^I Tab
010 ^J Linefeed
011 ^K Combination Command (System Parameters)
012 ^L Clear Screen
013 ^M Carriage Return
014 ^N [ Reserved ]
015 ^O [ Reserved ]
016 ^P [ Reserved ]
017 ^Q Used for XON/XOFF. NEVER USE THIS.
018 ^R [ Reserved ]
019 ^S Used for XON/XOFF. NEVER USE THIS.
020 ^T [ Reserved ]
021 ^U [ Reserved ]
QuickBBS Version 2.00 Documentation - Page 43
022 ^V [ Reserved ]
023 ^W [ Reserved ]
024 ^X [ Reserved ]
025 ^Y [ Reserved ]
026 ^Z MS-DOS end of file marker. NEVER USE THIS.
User Parameters (Combination Commands). Please note that the
second character is a normal character, NOT a control character.
ASCII #s Char Function
-------- ---- ----------------------------------------------------
006 065 ^FA Full User Name
006 066 ^FB City and State
006 067 ^FC Password (I WOULDN'T USE THIS, BUT ...)
006 068 ^FD Business/Data Phone Number
006 069 ^FE Home/Voice Phone Number
006 070 ^FF Last date user logged on
006 071 ^FG Last time user logged on
006 072 ^FH A Flags
006 073 ^FI B Flags
006 074 ^FJ C Flags
006 075 ^FK D Flags
006 076 ^FL Credit Value (expressed in cents)
006 077 ^FM # of times user has posted a message
006 078 ^FN highest message user read
006 079 ^FO security level of user
006 080 ^FP # of times user has logged on
006 081 ^FQ number of uploads user has sent
006 082 ^FR amount user has uploaded (expressed in kilobytes)
006 083 ^FS number of downloads user has received
006 084 ^FT amount user has downloaded (expressed in kilobytes)
006 085 ^FU elapsed time (in minutes) user used today
006 086 ^FV length of users screen (in number of lines)
006 087 ^FW user's first name (ie. Bob)
006 088 ^FX Returns ON or OFF according to the ANSI setting
006 089 ^FY Returns ON or OFF according to the More Prompt
setting
006 090 ^FZ Returns ON or OFF according to the Screen Clear
setting
System Parameters (Combination Commands). Please note the the
second character is a normal character, NOT a control character.
ASCII #s Char Function
-------- ---- ----------------------------------------------------
011 065 ^KA Number of calls on system
011 066 ^KB Name of last caller on system
011 067 ^KC Number of active messages in message base
011 068 ^KD Lowest system message number
011 069 ^KE Highest system message number
011 070 ^KF Number of Times User has Paged Sysop This Call
011 071 ^KG Day of the Week (ie. Monday, Tuesday, etc)
011 072 ^KH Number of users on system
011 073 ^KI Current time in 24-Hour Format (HH:MM)
QuickBBS Version 2.00 Documentation - Page 44
011 074 ^KJ Current date in DD-MMM-YY form
011 075 ^KK Minutes Connected
011 076 ^KL Seconds Connected
011 077 ^KM Minutes Used (against time limit)
011 078 ^KN Seconds Used (against time limit)
011 079 ^KO Minutes Remaining
011 080 ^KP Seconds Remaining
011 081 ^KQ Time Limit (expressed in minutes)
011 082 ^KR Current baud rate (300, 1200, or 2400)
011 083 ^KS Abbreviated Day of the Week (ie. Mon, Tue, etc)
011 084 ^KT Download Limit (expressed in kilobytes)
011 085 ^KU The number of minutes until the next system event.
011 086 ^KV The time of the next system event. (24 Hour format)
Required Software for Net Mail
-------- -------- --- --- ----
To run the Net Mail of QuickBBS you will need an external mailer
such as Binkley, DataBridge, Dutchie or SEAdog. You will have to set
up that mailer to work properly. A description of how to set up your
mailer is beyond the scope of this document. Please refer to your
Mailer documentation for instructions. You will also need the
QNET_200.ARC archive and a copy of Phil Katz's PKARC program. The
PKARC must be version 3.5 or higher. The QNET_200.ARC contains all of
the QuickBBS programs for Net Mail and Echo Mail operation. Unarc the
QNET_200 archive in your QuickBBS directory.
An Overview of the Net Organization
-- -------- -- --- --- ------------
The Net, as of this writing, consists of slightly under 3000
boards. To keep some type of order the Net is divided into three
zones. Each zone covers a large geographical area. Zone 1 is North
America, Zone 2 is Europe, Zone 3 is the Pacific Basin and Far East.
A zone address is a single digit. Each zone is further divided into
regions. Region addresses are two digits. regions are then divided
into Nets. Net addresses are three digits, except for private nets
which have 4 or more digits. Nets consist of one or more nodes. Each
individual board is a node in a net. You are setting up a node in
either a net or a region. Nodes are assigned to a region when they
are located in an area that is not covered by any nets.
If you do not have a Net/Node address contact you local Net Host
or Regional Coordinator for instructions on applying. If you do not
know who your Net Host is you can logon a local Net Mail board and
note what Net the board operates in. Send a message to 'Sysop' at
the Net/0. If you have no Net Mail board operating in your area you
can search the Nodelist file for a Regional coordinator that covers
your area. Contact one of the above persons for information on how to
apply for a Net/Node number. To qualify for a Net/Node address you
must be able to send and receive mail during your national mail hour
(9:00 to 10:00 GMT in North America). Your Net Host or Regional
Coordinator will tell you what Net/Node address to use when applying.
Overview of Net Mail Operation
QuickBBS Version 2.00 Documentation - Page 45
-------- -- --- ---- ---------
Net Mail is the automatic exchange of information between systems
in the network. The first systems to do this exchanged mail only at
specific times. Since then mailers have evolved to the point that
they now send and receive mail at any time. To do this a message must
go through several steps.
The message is entered on the originating board and placed in the
net mail directory for the mailer. This operation is performed by
MAILSCAN or ECHOGEN.
The message is bundled up with other messages destined for the
same board. The mailer then calls the destination board and sends the
bundle.
The destination board takes the bundle and unpacks it. This is
performed by ECHOGEN. Echomail is tossed by ECHOGEN the remaining
mail is tossed by MAILTOSS.
Configuring QuickBBS for Net Mail
----------- -------- --- --- ----
QuickBBS interfaces with your mailer by placing outgoing messages
in a net mail directory. Your mailer places incoming messages in this
same directory and picks up the outgoing messages to bundle them for
transmission. QuickBBS and your mailer must both point to the same
directory. in QuickBBS this directory is called the net mail path.
To run specify the net mail path for QuickBBS you will need to
run QCONFIG and set up the net mail options. You will also need to
set your net/node path as well as your zone. A net mail message
board will also need to be set up. Please refer to the QCONFIG
section for more information on how to do this.
You will now need to set up a menu to access the net mail area.
This menu will be similar to a menu that you use for the local mail
areas. In fact you can copy a local mail menu to net mail menu using
MENUEDIT and then edit the net mail menu so that all message board
operations point to the net mail message board number. Please refer
to the MENUEDIT section for more information on how to do this.
Compiling the Nodelist for QuickBBS
--------- --- -------- --- --------
QuickBBS must compile the node list if it is to perform net mail
operations. To do this you need to run the external program Qnode.
This will take the output of the Xlatlist program (not included with
this package) and convert it to a form compatible with QuickBBS. You
should run this program when ever you get an update to the nodelist.
The update file is usually called NODEDIFF.###, where ### is the day
of the year that the nodediff was created. Archived versions of the
list are usually called NODEDIFF.A##.
QuickBBS Version 2.00 Documentation - Page 46
To run Qnode you should be in the same directory that the
QuickBBS program resides in. Qnode has one command line parameter
this is the path to the directory that contains the Xlatlist output.
If you keep all of your network information in the same directory that
QuickBBS is in then you do not need to include this path.
Example:
Qnode C:\Mailer\Netstuff\
Two Techniques for Mail Handling
--- ---------- --- ---- --------
There are two basic types of mail systems. Those that are always
ready to send and receive mail and those that only send and receive
during specified times. These are called continuous and non-
continuous mailers.
Continuous Mailers
---------- -------
Continuous mailers will always answer the phone in case another
system is calling. Because of this they will have a method of loading
a bulletin board. There are two basic ways to do this: Spawn and
Exit. In either case you will need to pass QuickBBS some information
on the command line. The QuickBBS command line parameters are:
----------------------------------------------------------------------
-Bx = Baud rate of caller is x (i.e. -B1200)
-Tx = Time (in minutes) until the next event
-Ex = Exit after caller at ERRORLEVEL = x
-S = Snoop Mode Default to Off (For Multi-task people)
-R = Re-Logon a user after a Type 15 Exit
-L = Logon in Local Mode
-P = Log system activity to the printer if the printer is online
----------------------------------------------------------------------
If you use the Spawn option you will need to create a batch file
in the directory that you run the mailer from. To use this option the
mailer will have to allow you to send the baud rate of the caller. If
the mailer will allow you to pass the time to the next event it will
make things simpler. Examples of the spawn files are found in the
appendix dealing with mailers.
Some mailers exit to run the bulletin board. These programs
usually exit with an errorlevel equal to the baud rate divided by 10.
(i.e. errorlevel 12=1200) In this case you will need to place the
commands to run QuickBBS in your batch file that runs the mailer. To
ensure that QuickBBS does not allow a caller to overrun an external
event you will need to duplicate the mailer schedule in the QuickBBS
event configurations. Examples of the exit files are found in the
appendix dealing with mailers.
Non Continuous Mailers
--- ---------- -------
QuickBBS Version 2.00 Documentation - Page 47
Non continuous mailers only send and receive mail during
specified time slots called events. For a non continuous mailer to
run properly with QuickBBS QuickBBS must answer the phone during the
non mail events and then release the phone to the mailer for the mail
events. To do this the QuickBBS event schedule must be set up to exit
at the proper times with errorlevels set so a batch file can then
start the mailer. To edit the event schedules you will need to run
the QCONFIG program.
Getting Mail into the Net from QuickBBS
------- ---- ---- --- --- ---- --------
MAILSCAN is the program that will take the messages from the
QuickBBS mail message board and place it in your Net Mail directory so
the mailer can find it. If your mailer is continiously sending mail
then you should run this program whenever a user enters a message in
the net mail directory. If your mailer only sends mail during a
specific event then you only need to run this program immediately
before that event. The format for the program is "MAILSCAN #", where
# is the number of the message board that contains your Net Mail.
Because continuous are always ready to send mail you will
probably want to scan the message base for outgoing mail when a caller
has logged off of the bulletin board. QuickBBS provides a simple
method of determining when Mail has been entered. QuickBBS will set
the errorlevel upon exit if errorlevel exiting is enabled in the
QCONFIG program. The error levels are set as follows:
----------------------------------------------------------------------
0 = Normal Exit with either the {ESC} command or -L command line
option
1 = Important File Missing (i.e. Top.Mnu, etc.)
2 = Fatal System Error Occurred (Logged in ERRORS.LOG)
3 = New Net Mail was Entered
4 = Net Echo Mail was Entered
5 = Both Net Net Mail and Echo Mail were entered
----------------------------------------------------------------------
Getting Messages from the Net into QuickBBS
------- -------- ---- --- --- ---- --------
When your mailer gets mail from another board it will most
likely be in "bundles". Your system will need to take the "bundles"
and un-bundle them to re-create the messages as files with the
extension MSG in your netmail directory, this is done by the ECHOGEN
program with the -U option. From there MAILTOSS can take the
messages and import them into your netmail message board.
If you are running net mail without echo mail then you will need
to use the -F option on ECHOGEN. Please see the section on echo mail
for a complete discussion of how ECHOGEN works. Examples of mail use
of ECHOGEN are:
ECHOGEN -F -U -Z (in Ommm environment)
QuickBBS Version 2.00 Documentation - Page 48
ECHOGEN -F -U (in SEADog environment)
If you run a point system you will need to toss to mail to your
points after running ECHOGEN but before running MAILTOSS.
Once you have run ECHOGEN to unpack the incoming packets you
should run MAILTOSS take those messages and toss them into the
QuickBBS message base. MAILTOSS has one command line option. The -K
parameter will tell MAILTOSS not to toss null messages.
Overview of Echo Mail
-------- -- ---- ----
Echo mail is simply the sharing of a message base by two or more
boards. This is done by sending all messages entered in the echo area
to the other boards that are sharing the echo. In large nets you will
receive and send your echo's from one board. This board is referred
to as your echo host. Under more complex situations you may forward
mail to other boards. In this case you are the echo host for those
boards.
Echo mail is both as simple as described above and much more
complex. One of the problems that is often encountered in large nets
is the duplication of messages. This occurs when two boards are
sending the same echo to the same board. The board in the middle will
not recognize that the messages have been seen by the other boards and
forward them on. For this reason you should find out who your local
echo host is. This person will tell you what echos are currently
available in the net and will tell you who will be your host. You
should not forward the echo to any other board within your net without
approval of your echo host.
Configuring QuickBBS for Echo Mail
----------- -------- --- ---- ----
The only changes you need to make to your board is to add the
echo mail areas as message areas using QCONFIG. The only difference
is the the message board should be a type 3 (echo mail). Most echos
are public only. Sysops do not like to pay good money to send private
messages that is what net mail is for, so please be sure that the
types of messages allowed is set to Public only. Certain echos are
only open to sysops, please be sure that you do not allow non-sysop
users to enter messages in these areas.
Getting Echo Mail into the Net from QuickBBS
------- ---- ---- ---- --- --- ---- --------
The ECHOGEN program will scan the QuickBBS message base for echo
mail and create extract that mail. ECHOGEN is a very compact and fast
utility. In an Ommm environment ECHOGEN will create *.OUT files in
the outbound directory. This speeds up the processing of Ommm as Ommm
dosn't have to deal with the individual message files that would
normally be created by echo scanning processors. In a SEADog
QuickBBS Version 2.00 Documentation - Page 49
environment ECHOGEN creates archived packets that are ready for
transmisson. In order for ECHOGEN to work properly you must create a
ECHOMAIL.CTL file. This file must be in the directory from which you
run ECHOGEN and has the following format:
Node <Net>/<Node>
This is your main network and node number in
FidoNet, set this according to your other config
files for your system.
Aka <Net>/<Node> [<Net>/<Node> ...]
This line lists all of your node "Aliases"... up
to 20 aliases may be given on this line. Each
one must consist of a net and node number.
These are used to detect inbound EchoMail
addressed to your node.
PvtNode <Net>/<Node> [<Net>/<Node> ...]
This is an optional ECHOMAIL.CTL command that
is used when generating Echo Mail. If you are
not planning to implement echo mail you will
not need to use this option. This option defines
which node addresses are private and should not
be reconized by the rest of the net. What this
actually does is when a message is generated for
the node, the SEEN-BY lines only contains your
node address and the private node address. This
also leaves the private node address out of the
SEEN-BY lines of the original message. This is
also known as POINT Support. Up to 100 private
node addresses can be defined.
NetDir <Full Drive and Path>
This is where both your inbound and outbound
network mail is stored. This is where your
mailer will look for inbound and outbound mail.
This is the same as the Net Mail Path Statement
in QCONFIG or the MAIL or Net Mail Path
statement in your mailers configuration file.
PktDir <Full Drive and Path>
This is an optional statement defining the
directory used for temporary packets created
during Echo Mail extraction. If you are not
planning on implementing Echo Mail you will not
need this option. Some people like to store
there temporay packets on a RAMdisk so that
archiving packets and writing to packets is
faster than normal this option allows this to be
done. THIS PARAMETER IS ONLY USED WITH THE
ARCHIVE OPTION IN ECHOGEN, IT CAN NOT BE USED IN
AN OMMM ENVIRONMENT.
QuickBBS Version 2.00 Documentation - Page 50
ArcOutDir <Full Drive and Path>
This is where all outbound ARCmail files will be
stored. If this is not specified then the
current directory that you run ECHOGEN from will
be used. THIS PARAMETER IS ONLY USED WITH THE
ARCHIVE OPTION IN ECHOGEN, IT CAN NOT BE USED IN
AN OMMM ENVIRONMENT.
Outbound <Full Drive and Path>
This parameter defines where all outbound oMMM
bundles are stored. This is where ECHOGEN will
stored outbound bundles at, oMMM can then
manipulate them as wished. THIS PARAMETER IS
ONLY USED IF ECHOGEN IS BEING RUN IN AN OMMM
ENVIRONEMNT.
NetFileDir <Full Drive and Path>
This is an optional parameter that defines the
DOS path where all inbound ARCmail and/or .PKT
files are received at. THIS PARAMETER IS ONLY
USED IF THE UNPACK OPTION IS USED IN ECHOGEN.
Example ECHOMAIL.CTL for an OMMM environment:
----------------------------------------------------------------------
;
; EchoMail Control File
;
Node 104/24
NetDir C:\BINKLEY\MESSAGES
NetFileDir C:\BINKLEY\FILES
Outbound C:\BINKLEY\OUTBOUND
----------------------------------------------------------------------
Example ECHOMAIL.CTL for a system using the -A option in a Seadog
environment:
----------------------------------------------------------------------
;
; EchoMail Control File
;
Node 104/24
NetDir C:\SEADOG\MESSAGES
NetFileDir C:\SEADOG\FILES
ArcOutDir C:\SEADOG\ARCOUT
PktDir C:\SEADOG
----------------------------------------------------------------------
In addition to the control file ECHOGEN has several command line
arguments. These arguments modify the way ECHOGEN operates, they are:
-A ARC all mail generated (DO NOT USE THIS ON DUTCHIE OR SYSTEMS
THAT USE OMMM). At this time only PKARC is supported. Uses
PktDir and ArcOutDir lines in the ECHOMAIL.CTL1 file.
-B Run ECHOGEN in black and white mode. For use on non-color
QuickBBS Version 2.00 Documentation - Page 51
systems.
-C Mark all messages generated or ARCmail attaches as crash
priority mail. This can only be used with the -A option
above.
-E Extract echo mail from the QuickBBS message base. This
option scans the QuickBBS message base for echo messages that
have not been sent, extracts and packets them. Thie option
also disables the unpacking ( -U option) and the forwarding
of inbound echo mail. This means that you will need to run
ECHOGEN twice. Once to import the messages once to export
them.
-F<Name> This tells ECHOGEN to use another area list file other than
AREAS.BBS, immediately following the -F is the 1 to 8
character name of the area list. Example: ECHOGEN -FMYLIST
will read the area list file called MYLIST.BBS. If no
AREAS.BBS name is found after the -F then ECHOGEN will
simpley unpacket the mail.
-G This is a security feature. If this option is used then
ECHOGEN will not accept messages from net/node's that are not
listed in the AREAS.BBS file.
-H This makes all SEEN-BY lines hidden by the IFNA ^A kludge
when outputed. Some Echo mail processors cannot handle this
so use it with care.
-L<Name> This option is used in conjunction with the -T option (see
below). It creates/appends the <Name> file and lists all
areas that were tossed into. This file can later be used by
ECHOKDUP's -I command line switch.
-M<#> This sets the maximum limit of messages for ECHOGEN to
generate to whatever <#> equals. The default is 300.
-N Tells ECHOGEN to ignore any echo mail in your net mail area.
This prohibits someone from sending you echo mail that is not
packetised. This is used to make the system more secure.
-O This option suppresses all screen output status while
processing. Also known as quiet mode.
-P This tells ECHOGEN to use the ^aPath: statements and also to
generate them. These statements are compatible with ConfMail
3.x and MGM. If this option is not used then the path
statements are stripped.
-S This specifies how much free disk space is required before
ECHOGEN processing.
-T This will allow ECHOGEN to toss all Echo Mail into your
QuickBBS message base. EACH AREA MUST APPEAR ONLY ONCE. YOU
QuickBBS Version 2.00 Documentation - Page 52
CANNOT LIST AN AREA TWICE EVEN IF IT IS LISTED IN TWO
SEPARATE AREAS.BBS FILES.
-U This tells ECHOGEN to unarchive and unpacket all inbound
mail. For Binkley people who run QuickBBS this is a great
help, it will also unpack all xxxxxxxx.PKT files that Binkley
writes out.
-V This tells ECHOGEN NOT to forward any mail, this is useful
for people who only forward back to their hosts.
-X Mark all generated messages or ARCmail attaches as hold for
pickup. This option can only be used with the -A argument
above.
-Z This tells ECHOGEN you are operating in an OMMM environment
and will generate all messages out to xxxxxxxx.OUT files in
your outbound hold area. OMMM can later take these packet
files and ARC them if you wish. YOU CANNOT USE THIS OPTION
WITH -A, -C, OR -X.
Example:
ECHOGEN -M1000 -S256 -H -FAREAS1
This sets the Maximum messages allow to generate at 1000. It will hide
SEEN-BY lines. Uses the area list file: AREAS1.BBS And only processes
if 256k is free on your disk drive.
ECHOGEN -U -Z
This tells ECHOGEN to unpack any archives and that it is operating in
an OMMM environment.
ECHOGEN returns the following ERRORLEVELs:
0 = Everything went ok but no mail was generated
1 = Mail was generated, max msg limit not hit
2 = Mail was generated, max msg limit reached
3 = SysOp error (Missing File, Invalid Net/Node Number, etc)
You will need to create an AREAS.BBS file. This file tells
ECHOGEN what other systems you exchange the echomail with and where to
place incoming echo mail. There can be not more than 200 areas listed
in any one AREAS.BBS file. AREAS.BBS is the default name but can be
changed with the ECHOGEN -F arguemnt. Comments may be placed in this
file simply by making the first character of the comment line a semi-
colon ';'. The first line in your file is your Origin line, this line
is not actually used by ECHOGEN but is there for compatibility with
other EchoMail processors. Each line in the file is in the following
form:
<#> <Echo Name> <Forward Net/Node> [<Forward Node> ...]
QuickBBS Version 2.00 Documentation - Page 53
The <#> is the Area Number, you may put the letter P in place of <#>
to indicate that the Echo area is a "Pass-Through" area, this means
all mail is automatically killed after it is forwarded. This is used
by echo mail hosts who carry echo for their nodes that they do not
carry.
The <Echo Name> is the name of the EchoMail area.
The rest of the line must contain all the node numbers you forward
to. You can use this type setup also: "104/56 610 32" That would
indicate you are fowarding to 104/56, 104/610, and 104/32. If you do
not forward mail to any other systems you must still return echo mail
that is entered on your system to your host. You should ALWAYS place
your hosts address on this line.
Example:
----------------------------------------------------------------------
The Turbo Connection, (303)423-3114, Denver CO
;
; Forwarding Nodes: 104/32 42 46
;
1 FORSALE 104/610
2 COMM 104/610 46
3 TELIX 104/610 46
4 ECPROG 104/610 46
5 C_ECHO 104/610 46
6 WINDMILL 104/610 46
7 PASCAL 104/56
8 TECH 104/610
9 FIDOSYSP 104/610 42 46
10 NET_DEV 104/56
11 SEADOG 104/610 46
P MEADOW 104/610 42
13 SYSOP 104/610 46
14 SIRIUS 104/56 99
15 REGION15 104/56 46
16 TBBS 104/610
----------------------------------------------------------------------
Killing Duplicate Echo Messages
------- --------- ---- --------
ECHOGEN will kill duplicates when the messages are unpacked. If
you need to check your message base for duplicates in addition to this
function then you can run the ECHOKDUP program.
ECHOKDUP will scan the echo message areas, sort and then check
for and mark deletion duplicates messages. It will not remove the
duplicates from the file, this is done by Msgpack. ECHOKDUP has the
following command line options:
-D This tells ECHOKDUP not to actually delete any mail. NOTE:
ECHOKDUP will still act and say it is deleting messages.
QuickBBS Version 2.00 Documentation - Page 54
-F<Name> Use an alternate AREAS file, this tells ECHOKDUP to use a
file other than AREAS.BBS.
-I<Name> This defines the file the ECHOKDUP will read in for a list of
areas to kill duplicates on. Us this in combindation with
the -L option on ECHOGEN.
You are now ready to run QuickBBS with echo mail capability. You
may be interested in picking up the QuickBBS Sysop Echo. As of this
writing this echo is available on most backbone (also known as the
star) sites.
You are now ready to run QuickBBS with net mail.
QuickBBS Version 2.00 Documentation - Page 55
Binkley Batch File Examples
------- ----- ---- --------
There are two ways to load QuickBBS from Binkley. The first is
the Spawn technique. To use this technique you need to use the BBS
SPAWN option in the BINKLEY.CFG file. These examples assume that you
are using Com1 for communications and have the WatchCD program that
comes with the X00 fossil driver.
Example of Binkley with Spawn option. Note that the board is loaded
in local mode by use of the F2 key.
----------------------------------------------------------------------
echo off
set Binkley=C:\BT\
cd\bt
:start
cd\bt
bt
if ERRORLEVEL 31 goto start
if ERRORLEVEL 30 goto clean
if ERRORLEVEL 20 goto localbbs
if ERRORLEVEL 10 goto unpackmail
if ERRORLEVEL 9 goto start
if ERRORLEVEL 1 goto out
goto start
:localbbs
Rem Load the BBS in local Mode
Command /C Spawnbbs.bat local
goto start
:unpackmail
Rem Unpack the incoming pail
Rem EchoGen unpacks the bundles and tosses the echo mail
Rem Mail toss tosses the net mail in to board 3 while killing null
Rem messages
Rem Bundle mail if the new NodeDiff has not arrived.
Rem Compile the nodelist if it has arrived.
cd QuickBBS
EchoGen -B -P -I -G -T -U -V -Z
mailtoss -K 3
cd\bt\files
if NOT EXIST NodeDiff.* goto bundle
pkxarc nodediff.* c:\bt\networks\
erase nodediff.*
cd\bt\networks
xlatlist
opusnode -f
cd..\QuickBBS
qnode c:\bt\networks\
cd..
QuickBBS Appendix A - Batch File Examples - Page A-1
:bundle
Rem Run OMMM to bundle the outbound mail
cd\bt
c:\bt\ommm -s%sched% -hc:\bt\outbound\ -ic:\bt\binkley.prm
-mc:\bt\mail\ -cc:\bt\ommm.ctl
goto start
:clean
Rem Kill messages that are older than 7 days.
Rem Kill messages that have been received in the mail areas
Rem Pack the message base using the write-in-place mode and
Rem renumbering the messages
Rem Delete users that havn't called within the last 30 days
Rem Sort the user base
cd QuickBBS
msgutils Killold 1 2 3 4 5 6 7 8 -D7
msgutils Killrecv 1 2 3
msgpack -W -R
userpack -D30
usersort
goto start
:out
Echo Mojave Net Gateway ... Down
----------------------------------------------------------------------
Example of SPAWNBBS.BAT for the above RUNBBS.BAT file.
----------------------------------------------------------------------
cd QuickBBS
Rem If not loaded with F2 option go to local quick
Rem Run QuickBBS with baud rate, and time from binkley and exiting
Rem with an error level of 0 when the user logs off.
if %1==local goto local_quick
Quickbbs -b%1 -T%3 -E0
goto After_quick
:restart_quick
Rem Reload QuickBBS by relogging in the last user and exiting with an
Rem error level of 0 when the user logs off.
QuickBBS -R -E0
goto After_Quick
:local_Quick
Rem Load QuickBBS in local mode and exit with an error level of 0
Rem when the user logs off.
QuickBBS -L -E0
:After_Quick
Rem Check for error levels that require servicing.
Rem The outside is done via a menu call
Rem The error levels 3, 4, and 5 must be enables in the QCONFIG
Rem program.
if errorlevel 6 goto outside
QuickBBS Appendix A - Batch File Examples - Page A-2
if errorlevel 5 goto net&echo
if errorlevel 4 goto echo_only
if errorlevel 3 goto net_only
goto out
:outside
Rem Redirect Console I/O to Com1
Rem Watch for loss of carrier on Com1
Rem Run the external program
Rem Turn the carrier detect program off.
Rem Redirect the I/O back to the console
Rem Reload QuickBBS
ctty com1:
watchcd Com1: on
<Run external program here>
watchcd Com1: off
ctty con:
goto Restart_Quick
:net&echo
Rem Scan the QuickBBS message base for outgoing net mail
Rem Fall through to echo only
mailscan 3
:echo_only
Rem Scan the QuickBBS message base for outgoing echo mail
Rem bundle the packages created
echogen -E -P -Z
goto bundle
: net_only
Rem Scan the QuickBBS message base for outgoing net mail
Rem fall through to bundle the packages created
Mailscan 3
:bundle
Rem Run OMMM to bundle the messages
c:\bt\ommm -s%Sched% -hc:\bt\outbound\ -ic:\bt\binkley.prm
-mc:\bt\mail\ -cc:\bt\ommm.ctl
:out
cd..
----------------------------------------------------------------------
The other technique is the EXIT. To do this you should use the
BBS EXIT option in the BINKLEY.CFG file.
Example of RUNBBS.BAT file that uses Exit option
----------------------------------------------------------------------
echo off
set Binkley=C:\BT\
cd\bt
:start
QuickBBS Appendix A - Batch File Examples - Page A-3
cd\bt
bt
if ERRORLEVEL 31 goto out
if ERRORLEVEL 30 goto clean
if ERRORLEVEL 24 goto 2400_Baud
if ERRORLEVEL 20 goto localbbs
if ERRORLEVLE 12 goto 1200_Baud
if ERRORLEVEL 10 goto unpackmail
if ERRORLEVEL 3 goto 300_baud
if ERRORLEVEL 1 goto out
goto start
:2400_baud
Rem Run QuickBBS at 2400 baud and exit with an error level of 0 when
Rem the user logs off.
cd QuickBBS
Quickbbs -b2400 -E0
goto After_quick
:1200_baud
Rem Run QuickBBS at 1200 baud and exit with an error level of 0 when
Rem the user logs off.
cd QuickBBS
Quickbbs -b1200 -E0
goto After_quick
:300_baud
Rem Run QuickBBS at 300 baud and exit with an error level of 0 when
Rem the user logs off.
cd QuickBBS
Quickbbs -b300 -E0
goto After_quick
:localBBS
Rem Run QuickBBS in the local mode and exit with an error level of 0
Rem when the user logs off.
QuickBBS -L -E0
goto After_Quick
:Restart_Quick
Rem Restart Quickbbs by logging in the last user and exiting with an
Rem error level of 0 when the user logs off.
QuickBBS -R -E0
:After_Quick
Rem Check for error levels that require servicing
Rem Error level six is set from a menu that shells to the outside
Rem Error levels 3, 4, and 5 must be enabled in the QCONFIG program.
if errorlevel 6 goto outside
if errorlevel 5 goto net&echo
if errorlevel 4 goto echo_only
if errorlevel 3 goto net_only
goto start
QuickBBS Appendix A - Batch File Examples - Page A-4
:outside
Rem Change the Console I/O to Com1
Rem Turn on the carrier detect program
Rem Run the outside program
Rem Turn the carrier detect program off
Rem Change the I/O back to the console
Rem Reload the QuickBBS program
Ctty com1:
Watchcd com1: on
<Run outside program here>
Watchcd com1: off
Ctty con:
goto Restart_Quick
:net&echo
Rem scan the QuickBBS message base for outgoing mail
Rem fall through to echo scanning
mailscan 3
:echo_only
Rem scan the QuickBBS message base for outgoing echo mail
Rem go to bundle to bundle the generated messages
echogen -E -P -Z
goto bundle
: net_only
Rem scan the QuickBBS message base for outgoing mail
Rem go to bundle tp bundle the generated messages
Mailscan 3
goto bundle
:unpackmail
Rem EchoGen unpacks the incoming packets and tosses the echo mail
Rem Mail toss tosses the net mail into board 3 while killing the null
Rem messages
Rem If the new nodediff is not here then go to bundle any outbound
Rem messages
Rem Compile the new nodelist
Rem Fall through to bundle to bundle any messages that were
Rem generated
cd QuickBBS
EchoGen -B -G -P -T -U -V -Z
mailtoss 3 -K
cd\bt\files
if NOT EXIST NodeDiff.* goto bundle
pkxarc nodediff.* c:\bt\networks\
erase nodediff.*
cd\bt\networks
xlatlist
opusnode -f
cd..\QuickBBS
qnode c:\bt\networks\
cd..
QuickBBS Appendix A - Batch File Examples - Page A-5
:bundle
Rem Run OMMM to bundle the messages
cd\bt
c:\bt\ommm -s%sched% -hc:\bt\outbound\ -ic:\bt\binkley.prm
-mc:\bt\mail\ -cc:\bt\ommm.ctl
goto start
:clean
Rem Kill messages that are older than 7 days
Rem Kill messages that have been received in the non echo boards
Rem Pack the message base, checking for space, eraseing the backups
Rem when done, and renumbering the message base.
Rem Delete users that have not called in within the last 30 days
Rem Sort the user file
cd QuickBBS
msgutils Killold 1 2 3 4 5 6 7 8 -D7
msgutils Killrecv 1 2 3
msgpack -A -B -R
userpack -D30
usersort
goto start
:out
Echo Mojave Net Gateway ... Down
----------------------------------------------------------------------
DataBridge Batch file Examples
---------- ----- ---- --------
These examples assume that you have the QuickBBS programs as well
as the ARCMAIL programs.
----------------------------------------------------------------------
echo off
:loop
D:
cd \bridge
db
if errorlevel 90 goto PACK ; Just Pack Arcmail
if errorlevel 60 goto TM ; TossMail (After Mail Received)
if errorlevel 50 goto SCAN ; ScanMail (Before Mail Sent)
if errorlevel 20 goto QB ; Call Quick BBS Local
if errorlevel 10 goto END ; Break Out Of Mailer
goto loop
:SCAN
Rem Change to the proper drive and path
Rem Scan the QuickBBS message base for outgoing mail
Rem Scan the QuickBBS message base for outgoing echo mail
Rem Pack the generated messages
c:
cd \QuickBBS
QuickBBS Appendix A - Batch File Examples - Page A-6
mailscan
echogen -e -a
goto pack
:TM
Rem Change to the proper drive and path
Rem Unpack the incoming mail and toss the echo mail
Rem Toss the inbound net mail to board 2
C:
cd \QuickBBS
echogen -t -u -a
mailtoss 2
goto pack
:QB
Rem Change to the proper drive and path
Rem Run QuickBBS in local mode and a default error level exit of 0
Rem check for error levels that require servicing
C:
cd \QuickBBS
quickbbs -l -E0
if ERRORLEVEL 5 goto net&echo
if ERRORLEVEL 4 goto echo_only
if ERRORLEVEL 3 goto net_only
goto loop
:net&echo
Rem scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBs message base for outbound net mail
echogen -e -a
mailscan
goto pack
:echo_only
Rem scan the QuickBBS message base for outbound echo mail.
echogen -e -a
goto pack
:net_only
Rem scan the QuickBBS message base for outbound net mail
mailscan
goto pack
:PACK
Rem Use Arcmail to pack up all of the outbound mail
arcmail to 129/34 -kfd0
arcmail to 135/68 -kfd0
arcmail to 104/24 -kfd0
arcmail to 107/27 -kfd0
arcmail to 107/35 -kfd0
arcmail to 107/519 -kfd0
arcmail to 115/761 -kfd0
arcmail to 135/4 -kfd0
arcmail to 107/337 -kfd0
QuickBBS Appendix A - Batch File Examples - Page A-7
arcmail to 141/250 -kfd0
goto loop
:END
echo on
----------------------------------------------------------------------
This is the spawn file for the above batch file.
----------------------------------------------------------------------
Rem Change to the proper drive and path
Rem Run QuickBBS in local mode and a default error level exit of 0
Rem check for error levels that require servicing
echo off
C:
cd \QuickBBS
quickbbs -b%1 -t%3 -e0
if ERRORLEVEL 5 goto net&echo
if ERRORLEVEL 4 goto echo_only
if ERRORLEVEL 3 goto net_only
goto out
:net&echo
Rem scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBs message base for outbound net mail
echogen -e -a
mailscan
goto pack
:echo_only
Rem scan the QuickBBS message base for outbound echo mail.
echogen -e -a
goto pack
:net_only
Rem scan the QuickBBS message base for outbound net mail
mailscan
goto pack
:PACK
Rem Use Arcmail to pack up all of the outbound mail
arcmail to 129/34 -kfd0
arcmail to 135/68 -kfd0
arcmail to 104/24 -kfd0
arcmail to 107/27 -kfd0
arcmail to 107/35 -kfd0
arcmail to 107/519 -kfd0
arcmail to 115/761 -kfd0
arcmail to 135/4 -kfd0
arcmail to 107/337 -kfd0
arcmail to 141/250 -kfd0
:out
D:
QuickBBS Appendix A - Batch File Examples - Page A-8
cd \bridge
----------------------------------------------------------------------
Dutchie Batch File Examples
------- ----- ---- --------
Example of Dutchie RUNBBS.BAT with Spawn option.
----------------------------------------------------------------------
echo off
cls
:restart
cd\Dutchie
Dutchie
if ERRORLEVEL 90 goto editor
if ERRORLEVEL 35 goto pollhub
if ERRORLEVEL 30 goto nodelist
if ERRORLEVEL 25 goto housekeep
if ERRORLEVEL 20 goto tossmail
goto exit
:tossmail
Rem Echogen unpacks the mail and tosses inbound echo mail
Rem Mailtoss tosses incoming messages into board 7
cd \QuickBBS
EchoGen -B -G -U -P -FQ_Areas -T
MailToss 7
goto restart
:housekeep
Rem Kill messages older than 30 days in some boards
Rem Kill messages older than 15 days in some boards
Rem Kill messages older than 10 days in some boards
Rem Pack the message base checking for free space and deleting the
Rem backup files when finished
Rem Delete users that havn't called within the last 60 days
cd \QuickBBS
MsgUtils KillOld 2 3 14 21 41 42 44 -D30
MsgUtils KillOld 1 4 6 9 10 12 13 15 16 17 23 29 30 35 39 40 -D15
MsgUtils KillOld 11 32 33 -D10
MsgPack -A -B
UserPack -D60
goto restart
:nodelist
Rem copy the new nodediff file
Rem copy the old nodelist file
Rem compile the nodelist
copy c:\mail\netfiles\nodediff.*/v >nul:
del c:\mail\netfiles\nodediff.*
copy nodediff.* \files\sysop\*.arc/v >nul:
arce nodediff.a*
xlatlist cle for xlatzone.ctl
Dutchcom 1
QuickBBS Appendix A - Batch File Examples - Page A-9
xlatlist for xlatqbbs.ctl
copy nodelist.bbs c:\QuickBBS/v >nul:
del nodelist.bbs
cd \QuickBBS
QNode
del nodelist.bbs
goto restart
:pollhub
Rem Run ROBOT to create a Poll Message for the Echo Hub
robot
goto restart
:editor
rem run the Duched editor
Dutched
goto restart
:exit
cls
----------------------------------------------------------------------
Example of SPAWNBBS.BAT file for Dutchie:
----------------------------------------------------------------------
Rem load QuickBBS with the Baud rate and time remaining as specified
Rem by dutchie and with a default error level of 0
echo off
cls
cd \QuickBBS
QuickBBS -B%2 -T%4 -E0
goto checkit
:relogin
Rem Re-logon the last user
QuickBBS -E0 -R
:checkit
Rem Check for error levels requireing servicing
Rem error level 10 is called from a menu option within quick
Rem error levels 3, 4, and 5 must be enabled in the QCONFIG program
if ERRORLEVEL 10 goto remotedos
if ERRORLEVEL 5 goto bothnew
if ERRORLEVEL 4 goto echomail
if ERRORLEVEL 3 goto netmail
goto exit
:bothnew
Rem scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBS message base for outbound net mail
EchoGen -E -FQ_Areas -P
MailScan
goto exit
:netmail
QuickBBS Appendix A - Batch File Examples - Page A-10
Rem scan the QuickBBS message base for outbound net mail
MailScan
goto exit
:echomail
Rem scan the QuickBBS message base for outbound echo mail
EchoGen -E -FQ_Areas -P
goto exit
:remotedos
Rem change the default I/O to com1
Rem watch for carrier detect loss on com1
Rem load another copy of command.com
Rem turn the carrier detect program off
Rem Change the default I/O to the console
Rem Relogin the user
ctty gate1
echo Type EXIT followed by [Enter] to return to Casper's Place
watchcd com1 on
c:\command
watchcd com1 off
ctty con
cls
goto relogin
:exit
cd \Dutchie
cls
----------------------------------------------------------------------
When running QuickBBS with a non-continuous mailer you will need
to load the mailer at a specific time of day and then reload QuickBBS
after the mailer has run. This example assumes that message board 1
is the net mail area.
----------------------------------------------------------------------
Echo Off
:Begin
Echo Loading QuickBBS
QuickBBS
If ErrorLevel 6 goto RunMailer
If ErrorLevel 1 goto MajorError
goto done
:RunMailer
Rem Scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBS message base for outbound net mail
Rem Run the bundler and mailer
Rem Toss the incoming echo mail
Rem Toss the incoming net mail
Rem Kill messages older than 20 days
Rem Kill received messages in the mail sections
Rem Pack the message base with the write-in-place option
EchoGen -E
QuickBBS Appendix A - Batch File Examples - Page A-11
MailScan 1
>>> run bundler and mailer here <<<
EchoGen -T -U
MailToss
MsgUtils KillOld 1 2 3 4 5 6 7 8 9 10 -D20
MsgUtils KillRecv 1 2 3
MsgPack -W
goto Begin
:MajorError
Echo A Major error has occured...Please check the log
:Done
Echo QuickBBS down
----------------------------------------------------------------------
SEADog Batch File Examples
------ ----- ---- --------
The first method of loading QuickBBS from SEAdog is the spawn
method. To do this you will need to place a statement similiar to
this in your SEAdog CONFIG.DOG file:
BBS C:\QUICKBBS\SPAWNBBS.BAT *B *T
This would run the batch file SPAWNBBS.BAT in C:\QUICKBBS directory
passing the baud rate and the time till next event on the command
line. For this method of loading the board you may want to include a
*D on your BBS line in CONFIG.DOG. This tells SEAdog to re-execute
any mail event after returning from the BBS incase any Net/Echo mail
was generated.
The RUNBBS.BAT file would look somthing like this:
----------------------------------------------------------------------
echo off
:loop
cls
mailer
if errorlevel 102 goto msgmaint
if errorlevel 101 goto domail
if errorlevel 100 goto end
if errorlevel 30 goto loop
if errorlevel 20 goto domail
goto loop
:domail
Rem Echogen unarchives the incoming mail and tosses the echo mail
Rem Mailtoss tosses the net mail into board 3
Rem if the new nodediff exists compile it
cd c:\QuickBBS
EchoGen -P -A -C -U -T -G
MailToss 3
cd c:\seadog
if not exist c:\seadog\files\nodediff.a?? goto loop
\pkxarc \seadog\files\nodediff.a* \seadog\
erase \seadog\files\nodediff.a*
QuickBBS Appendix A - Batch File Examples - Page A-12
xlatlist
nlcomp nodelist.bbs
del nodediff.*
cd c:\quickbbs
qnode c:\seadog
cd c:\seadog
goto loop
:msgmaint
Rem Kill messages older than 15 days
Rem Kill received messages on board 1
Rem Pack the message base checking for disk space first, renumbering
Rem the messages, and deleting the backups when done
Rem Delete the users who have not called in the last 60 days and
Rem delete the backups
Rem Sort the user file
cd c:\quickbbs
msgutils killold 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 -d15
msgutils killrecv 1
msgpack -a -r -b
userpack -d60 -b
usersort
cd c:\seadog
goto loop
:end
Echo Turbo Connect Down
----------------------------------------------------------------------
The SPAWNBBS.BAT file for the above example would look something like:
----------------------------------------------------------------------
Rem Load QuickBBS with the baud rate specified by SEAdog, the time
Rem remaining, and a default error level of 0
echo off
cd \QuickBBS
QuickBBS -B%1 -T%2 -E0
goto After_Quick
:Restart_Quick
Rem re-logon the last user
QuickBBS -R -E0
:After_Quick
Rem check for error levels that require processing
Rem error level 6 is set from a menu in QuickBBS
Rem error levels 3, 4, and 5 require that the exit after mail option
Rem be turned on in the QCONFIG program
if ERRORLEVEL 6 goto Outside
if ERRORLEVEL 5 goto both
if ERRORLEVEL 4 goto newecho
if ERRORLEVEL 3 goto newnet
goto end
:Outside
QuickBBS Appendix A - Batch File Examples - Page A-13
Rem redirect the console I/O to com1
Rem turn on the carrier detect on com1
Rem run the programs
Rem turn the carrier detect program off
Rem redirect the I/O back to the console
Rem restart the board
Ctty Com1:
Watchcd Com1: on
<Run outside program here>
Watchcd Com1: off
Ctty Con:
goto Restart_Quick
:both
Rem scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBS message base for outbound net mail
EchoGen -A -C -P -E
MailScan 3
goto end
:newecho
Rem scan the QuickBBS message base for outbound echo mail
EchoGen -A -C -P -E
goto end
:newnet
Rem scan the QuickBBS message base for outbound net mail
MailScan 3
:end
cd c:\seadog
----------------------------------------------------------------------
The second method of setting up SEAdog to load QuickBBS would use
a statement similar to the following in the CONFIG.DOG:
BBS *X
This would tell SEAdog to exit the MAILER.EXE program with the callers
baud rate divided by 100. The RUNBBS.BAT file to process this would
look like this:
----------------------------------------------------------------------
echo off
:loop
cls
mailer
if errorlevel 102 goto msgmaint
if errorlevel 101 goto domail
if errorlevel 100 goto end
if errorlevel 30 goto loop
if errorlevel 24 goto 2400_baud
if errorlevel 20 goto domail
if errorlevel 12 goto 1200_baud
if errorlevel 10 goto cleanup
if errorlevel 3 goto 300_baud
goto loop
QuickBBS Appendix A - Batch File Examples - Page A-14
:2400_baud
Rem load QuickBBS at 2400 baud and a default error level exit of 0
cd \QuickBBS
QuickBBS -B2400 -E0
goto After_Quick
:1200_baud
Rem load QuickBBS at 1200 baud and a default error level exit of 0
cd \QuickBBS
QuickBBS -B1200 -E0
goto After_Quick
:300_baud
Rem load QuickBBS at 300 baud and a default error level exit of 0
cd \QuickBBS
QuickBBS -B300 -E0
goto After_Quick
:Restart_Quick
Rem re-logon the last user
QuickBBS -R -E0
:After_Quick
Rem check the error levels that require subsequent processign
Rem error level 6 is set from a menu within QuickBBS
Rem error levels 3, 4, and 5 must be enabled in the QCONFIG program
if ERRORLEVEL 6 goto Outside
if ERRORLEVEL 5 goto both
if ERRORLEVEL 4 goto newecho
if ERRORLEVEL 3 goto newnet
goto finish_quick
:Outside
Rem redirect console I/O to com1
Rem Turn on the carrier detect program
Rem Run the outside program
Rem Turn off the carrier detect program
Rem redirect I/O to console
Ctty Com1:
Watchcd com1: on
<Run outside program here>
Watchcd com1: off
Ctty Con:
goto Restart_Quick
:both
Rem Scan the QuickBBS message base for outbound echo mail
Rem scan the QuickBBS message base for outbound net mail
EchoGen -A -C -P -E
MailScan 3
goto finish_quick
:newecho
QuickBBS Appendix A - Batch File Examples - Page A-15
Rem Scan the QuickBBS message base for outbound echo mail
EchoGen -A -C -P -E
goto finish_quick
:newnet
Rem scan the QuickBBS message base for outbound net mail
MailScan 3
:finish_quick
cd\seadog
goto loop
:domail
Rem echogen unpacks the incoming mail and tosses the echo mail
Rem mailtoss tosses the incoming net mail into board 3
Rem if the new nodelist is not here reload SEAdog
Rem compile the nodelist
cd c:\QuickBBS
EchoGen -P -A -C -U -T -G
MailToss 3
cd c:\seadog
if Not exist c:\seadog\files\nodediff.a?? goto loop
\pkxarc \seadog\files\nodediff.a* \seadog\
erase \seadog\files\nodediff.a*
xlatlist
nlcomp nodelist.bbs
del nodediff.*
cd c:\quickbbs
qnode c:\seadog
cd c:\seadog
goto loop
:msgmaint
Rem kill messages older than 15 days
Rem Kill received messages in board 1
Rem pack the message base checking for disk space first, renumbering
Rem the message base, and deleting the backup files
Rem delete users that have not called in 60 days and delete the
Rem backup file
Rem Sort the user file
cd c:\quickbbs
msgutils killold 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 -d15
msgutils killrecv 1
msgpack -a -r -b
userpack -d60 -b
usersort
cd c:\seadog
goto loop
:end
Echo Turbo Connect Down
----------------------------------------------------------------------
QuickBBS Batch File Examples
QuickBBS Appendix A - Batch File Examples - Page A-16
-------- ----- ---- --------
This batch file is an example of a batch file to run QuickBBS
without a front end mailer.
----------------------------------------------------------------------
Echo off
:Begin
Rem Run QuickBBS
Rem error level 6 is set in the events section of QCONFIG
Echo Loading QuickBBS
QuickBBS
If Errorlevel 6 goto CleanMsgs
If Errorlevel 3 goto Begin
If Errorlevel 1 goto MajorError
goto Done
:CleanMsgs
Rem Kill messages older than 15 days
Rem Kill received messages in boards 1 and 2
Rem pack the message base using the write-in-place mode
Rem delete users that have not loged on in the last 20 days
MsgUtil KillOld 1 2 3 4 5 6 7 8 9 10 -D15
MsgUtil KillRecv 1 2
MsgPack -W
UserPack -D20
goto Begin
:MajorError
Echo A Major Error Has Occured...
Echo Please check the Error log for more information
:Done
Echo QuickBBS Down
----------------------------------------------------------------------
QuickBBS Appendix A - Batch File Examples - Page A-17
ASC/ANS File Control Characters
------- ---- ------- ----------
ASCII #s Char Function
-------- ---- ----------------------------------------------------
001 ^A Pause and Wait for the ENTER key to be pressed
002 ^B Turn <S>top Aborting Off
003 ^C Turn <S>top Aborting On
004 ^D Turn More Prompts On
005 ^E Turn More Prompts Off
006 ^F Combination Command (User Parameters)
007 ^G Ring Caller's Bell
008 ^H Backspace
009 ^I Tab
010 ^J Linefeed
011 ^K Combination Command (System Parameters)
012 ^L Clear Screen
013 ^M Carriage Return
014 ^N [ Reserved ]
015 ^O [ Reserved ]
016 ^P [ Reserved ]
017 ^Q Used for XON/XOFF. NEVER USE THIS.
018 ^R [ Reserved ]
019 ^S Used for XON/XOFF. NEVER USE THIS.
020 ^T [ Reserved ]
021 ^U [ Reserved ]
022 ^V [ Reserved ]
023 ^W [ Reserved ]
024 ^X [ Reserved ]
025 ^Y [ Reserved ]
026 ^Z MS-DOS end of file marker. NEVER USE THIS.
ASCII #s Char Function
-------- ---- ----------------------------------------------------
006 065 ^FA Full User Name
006 066 ^FB City and State
006 067 ^FC Password (I WOULDN'T USE THIS, BUT ...)
006 068 ^FD Business/Data Phone Number
006 069 ^FE Home/Voice Phone Number
006 070 ^FF Last date user logged on
006 071 ^FG Last time user logged on
006 072 ^FH A Flags
006 073 ^FI B Flags
006 074 ^FJ C Flags
006 075 ^FK D Flags
006 076 ^FL Credit Value (expressed in cents)
006 077 ^FM # of times user has posted a message
006 078 ^FN highest message user read
006 079 ^FO security level of user
006 080 ^FP # of times user has logged on
006 081 ^FQ number of uploads user has sent
006 082 ^FR amount user has uploaded (expressed in kilobytes)
006 083 ^FS number of downloads user has received
QuickBBS Appendix B - Ascii Codes - Page B-1
006 084 ^FT amount user has downloaded (expressed in kilobytes)
006 085 ^FU elapsed time (in minutes) user used today
006 086 ^FV length of users screen (in number of lines)
006 087 ^FW user's first name (ie. Bob)
006 088 ^FX Returns ON or OFF according to the ANSI setting
006 089 ^FY Returns ON or OFF according to the More Prompt
setting
006 090 ^FZ Returns ON or OFF according to the Screen Clear
setting
ASCII #s Char Function
-------- ---- ----------------------------------------------------
011 065 ^KA Number of calls on system
011 066 ^KB Name of last caller on system
011 067 ^KC Number of active messages in message base
011 068 ^KD Lowest system message number
011 069 ^KE Highest system message number
011 070 ^KF Number of Times User has Paged Sysop This Call
011 071 ^KG Day of the Week (ie. Monday, Tuesday, etc)
011 072 ^KH Number of users on system
011 073 ^KI Current time in 24-Hour Format (HH:MM)
011 074 ^KJ Current date in DD-MMM-YY form
011 075 ^KK Minutes Connected
011 076 ^KL Seconds Connected
011 077 ^KM Minutes Used (against time limit)
011 078 ^KN Seconds Used (against time limit)
011 079 ^KO Minutes Remaining
011 080 ^KP Seconds Remaining
011 081 ^KQ Time Limit (expressed in minutes)
011 082 ^KR Current baud rate (300, 1200, or 2400)
011 083 ^KS Abbreviated Day of the Week (ie. Mon, Tue, etc)
011 084 ^KT Download Limit (expressed in kilobytes)
011 085 ^KU The number of minutes until the next system event.
011 086 ^KV The time of the next system event. (24 hour format)
QuickBBS Appendix B - Ascii Codes - Page B-2
Keys that Work While A user is on line
---- ---- ---- ----- - ---- -- -- ----
Key Use
--- ---
Alt-C Begin Chat mode. This will allow you
to talk (type) to the user that is
currently on line. Press "{Esc}" to
end the chat mode.
Alt-D Display toggle, This is for multi-
tasking environments where you may not
want to see what the user is doing.
Alt-D will turn the display on or off.
Alt-F Change the users flags. This is used
to change any of the 4 privilege flags
for the user.
Alt-H Hang up now! Disconnects the user.
Alt-J Jump to DOS. This will allow you to
jump to DOS while the user is on line
to perform some task. Type Exit to
return to QuickBBS.
Alt-L Lockout the user. This will logoff
the user like Alt-H but in addition
will change the users security level
to 0 so that he/she will not have
access to the board any longer.
Alt-P Log to the printer. This will toggle
the printer log swich. This causees
the System.Log file to be sent to the
printer. If the printer is not online
then the flag is reset to off. This
can also be done from a command line
parameter.
Alt-S Change the security level of the user
currently on line. The current
security level will be displayed and
you will be able to type in a new
level for the user.
the up arrow Increases the users time limit by 1
minute.
the down arrow Decreases the users time limit by 1
minute.
QuickBBS Appendix C - Keys That Work While User is Online - Page C-1
Home Displays a help menu locally
End Removes any windows and returns to the
normal screen.
PgDn Display extra stats on the user.
All other keys All other keys work as though the user
pressed them. This means that you can
answer a page, by chatting with the
user, and them help him/her through
the menus by pressing the appropriate
keys.
QuickBBS Appendix C - Keys That Work While User is Online - Page C-2
Menu Types and Optional Data
---- ----- --- -------- ----
Type Description Optional Data
0 .... Text Line (Not Considered a Command) .. None
1 .... Goto New Menu ......................... <Menu Name> <Password>
2 .... Gosub New Menu ........................ <Menu Name> <Password>
3 .... Return from Previous Gosub ............ None
4 .... Clear Gosub Stack and Goto New Menu ... <Menu Name>
5 .... Display .ASC/.ANS File ................ <1-8 Character Name>
6 .... Selection Menu ....................... <1-7 Character Prefix>
7 .... Shell Under Board and Run Program .. See Text
*B Passes Baud Rate (300, 1200, 2400
and 0 for Local)
*C Full path to COMMAND.COM as set in
the DOS environment variable
COMSPEC.
*F First Name of User
*G Graphics Mode (Off is 0, 1 is On)
*H Tells QuickBBS to shell with the
fossil hot (Open).
*L Last Name of User
*R Record Number of User for the User
Database
*T Time Left for Call (in minutes)
8 .... Version Information ................... None
9 .... Logoff the System ..................... None
10 ... Display System Usage Graph ............ None
11 ... Page the Sysop for Chat ............... Page Prompt
12 ... Execute Questionnaire File ......... <1-8 Character Q-A Name>
See appendix E for Questionnaire Command Language
13 ... List/Search User List ................. None
14 ... Time Statistics ....................... None
15 ... Exit to DOS ........................... <DOS ERRORLEVEL>
16 ... Change City and State ................. None
QuickBBS Appendix D - Menu Types and Optional Data - Page D-1
17 ... Change Password ....................... None
18 ... Change Length of Screen ............... None
19 ... Toggle Screen Clearing ................ None
20 ... Toggle Page Pausing ................... None
21 ... Toggle Graphics Mode .................. None
22 ... Check for Personal Mail ............... None
23 ... Read Messages ......................... <Board #>
24 ... Scan Messages ......................... <Board #>
25 ... Quick-Scan Messages ................... <Board #>
26 ... Delete Selected Messages .............. <Board #>
27 ... Post a New Message ......... <Board #> [/L] [/T=<Name>] [/A]
28 ... Select Combined Boards ................ None
29 ... Move A File ........................... <Full Path>
30 ... MS-DOS Directory ...................... <Full Path>
31 ... List FILES.BBS ........................ <Full Path>
32 ... Download a File from Sub-Dir .......... <Full Path> <Password>
33 ... Upload a File to Sub-Dir .............. <Full Path>
34 ... List Archive in Sub-Dir ............... <Full Path>
35 ... Search for File by Keyword ............ None
36 ... Search for File by FileName ........... None
37 ... List New Files on System .............. None
38 ...*Download a Specific file .............. <Full Path and Name>
39 ... Display a Direct Text File ............ <Full Path and Name>
40 ... Display .ASC/.ANS File -w- Hot Keys ... <1-8 Character Name>
41 ... Toggle Full Screen Editor ............. <None>
Options marked with an asterisk are not yet implemented.
QuickBBS Appendix D - Menu Types and Optional Data - Page D-2
Questionnaire Command Language:
------------------------------------------
Ask <Len> <Var Num>
Example: Ask 60 3
This command inputs up to <Len> characters and stores the result
in variable number <Var Num>. The <Len> can be from 1 to 255.
------------------------------------------
ChangeColor <Foreground> <Background>
Example: ChangeColor 15 1
This command changes the current color if the user has ANSI
selected, the <Foreground> can be from 0 to 15 and the <Background>
can be from 0 to 7.
------------------------------------------
ClearScreen
Example: ClearScreen
This clears the callers screen, but only if the caller has
selected screen clearing.
------------------------------------------
Display "<String>"
Example: Display "Question #1: What is your real name?"
This command simply just displays the character string <String>,
remember you MUST place the quotes around your output string.
------------------------------------------
Endif
Example: Endif
This command terminates an If statement (see below).
------------------------------------------
If <Var Num> = "<Test String>"
Example: If 3 = "Adam"
This command does a comparison on a variable number and the <Test
String>. The test is not case sensitive. If the comparison is true
then the following questionnaire lines are processed until an endif is
reached, otherwise all statements through the Endif are skipped.
NOTE: YOU MUSY HAVE A SPACE BEFORE AND AFTER THE EQUALS '='
QuickBBS Appendix E - Questionnaire Command Language - Page E-1
SIGN! ALSO, THE IF STATEMENT MUST BE TERMINATED BY AN ENDIF
STATEMENT.
------------------------------------------
GetChoice <Choices> <Var Num>
Example: Choices 12345 3
This command inputs one character which will consist of an item
in the <Choices>. The result is stored in variable number <Var Num>.
------------------------------------------
OutputAnswer "<Descriptor>" <Var Num>
Example: OutputAnswer "NAME: " 2
This command will output the contents of <Var Num> to the answer
file and label it with the string <Discriptor>.
------------------------------------------
PostInfo
Example: PostInfo
This command simply posts the user's information in the answer
file. It includes Name, Calling From, and Time-Date stamp of entry.
------------------------------------------
Quit
Example: Quit
This command terminates the questionnaire script and closes the
answer file.
------------------------------------------
SetFlag <Flag Set><Flag Number> <ON|OFF>
Example: SetFlag D5 ON
This command will alter the user's flag sets, <Flag Set> is A
through D, and <Flag Number> is 1 through 8 specifying the leftmost to
rightmost flags respectively. You can either turn a flag on or off.
------------------------------------------
NOTE: A CR/LF sequence can be placed in strings within quotes (") by
placing a | character in it. This can be used to get the display
command to display to terminate the line.
NOTE: The reference <Var Num> has the range of 1 to 20. This means
you have twenty variables to work with, each of which can be up to 255
characters long.
QuickBBS Appendix E - Questionnaire Command Language - Page E-2
QuickBBS provides a standard interface between itself and the
external full screen editor. The editor must use the temporary work
file called MSGTMP (no extension) in the QuickBBS directory. If the
user is replying to a message then QuickBBS will ask the user if they
wish to quote the reply message text. If so, the MSGTMP file will be
created before calling the editor and quoted text will be placed in
the file with a hard return/line feed sequence after each quoted line.
The message editor must be able to handle the message text
accordingly, this means inserting "soft" returns (ASCII 141) in the
file when lines are wrapped and "hard" returns when the user actually
hits the enter carriage return key.
QuickBBS gets the name of the editor's program file in its
configuration file. When the editor is called, several command line
parameters are passed to to. Here is what's passed:
ED.EXE <Port Number> <Baud Rate> <Time Remaining> <Inactive Limit>
<Port Number> is the communications port number.
<Baud Rate> is the callers baud rate, 0 is passed when in local
mode.
<Time Remaining> is the number of minutes remaining for the user on
his/her call.
<Inactive Limit> is the number of seconds the user is allowed to
stay idle (no COMM I/O) before the system will disconnect. This
value is retreived from the QuickBBS configuration file.
When the editor returns to QuickBBS, certain errorlevel codes must be
passed back. They are:
0 = Normal exit, message edited and ready to save
1 = User aborted the message, do not save
2 = User inactivity timeout, instructs QuickBBS to hang-up
If QuickBBS sees there is no carrier after the editor has returned
control, it assumes that the user hung-up and discards the message
text.
The editor is called directly, another copy of COMMAND.COM is NOT
loaded. This is found to be MUCH faster and take up less memory.
This interface was designed for the Sysop to install or write his own
full screen message editor for QuickBBS.
QuickBBS will only allow ANSI Graphics users access to the editor.
The editor will most likely want to use the VT-100/ANSI screen control
codes to handle such tasks as locating to possitions and erasing the
screen.
QuickBBS Appendix F - Full Screen Editor Interface - Page F-1
The editor must be able to handle it's own communications I/O either
using the FOSSIL driver or it's own routines.
In EchoMail messages entered, QuickBBS will automatically add the
origin line to the text.
QuickBBS Appendix F - Full Screen Editor Interface - Page F-2
INDEX
A - D
AREAS.BBS 53
Binkley - Exit Option A-3
Binkley - Spawn Option A-1
Changing Menu Flags 38
Changing Message Board Flags 38
Changing Security Levels - Online 37
Changing Security Levels - Online C-1
Changing User Flags - Global 33
Changing User Flags - Offline 31
Changing User Flags - Offline 37
Changing User Flags - Online 36
Changing User Flags - Online C-1
Changing User Time Limit - Online 37
Changing User Time Limit - Online C-1
Chatting 36
Chatting C-1
Command Line Parameters 47
CONFIG.SYS 1
CONFIG.SYS - BUFFERS 1
CONFIG.SYS - FILES 1
Configuring - Message Boards 2
Continuous Mailers 47
DataBridge - Spawn Option A-6
DNLDHRS.A?? 41
DSZ 1
Dutchie - Spawn Option A-9
E
ECHOGEN 49
ECHOGEN - Command Line Arguments 51
ECHOKDUP 54
ECHOMAIL.CTL 50
ECHOMAIL.CTL - Examples 51
ECHOORIG.CTL 39
EDITHELP.A?? 41
Errorlevels - ECHOGEN 53
Errorlevels - QUICKBBS 48
ERRORS.LOG 38
ERRORS.LOG 48
Exit BBS 47
EXITINFO.BBS 16
EXITINFO.BBS 20
External File - AREAS.BBS 53
External File - DNLDHRS.A?? 41
External File - ECHOMAIL.CTL 50
External File - ECHOORIG.CTL 39
External File - EDITHELP.A?? 41
QuickBBS Index - Page Index-1
External File - ERRORS.LOG 38
External File - ERRORS.LOG 48
External File - EXITINFO.BBS 16
External File - EXITINFO.BBS 20
External File - FLSEARCH.CTL 39
External File - GOODBYE.A?? 41
External File - LASTREAD.BBS 6
External File - LIMITS.CTL 40
External File - LOGO.ASC 41
External File - MAXPAGE.A?? 41
External File - NEWS.A?? 41
External File - NEWUSER.Q-A 17
External File - NEWUSER1.ASC 41
External File - NEWUSER2.A?? 42
External File - NO300.ASC 42
External File - NOTAVAIL.A?? 42
External File - NOTFOUND.ASC 42
External File - PAGEABRT.A?? 42
External File - PAGED.A?? 42
External File - PASSWORD.A?? 42
External File - PHONENUM.CTL 40
External File - PRIVATE.ASC 42
External File - READHELP.A?? 42
External File - SEC#.A?? 42
External File - SYSINFO.BBS 39
External File - TIMELOG.BBS 38
External File - TIMEWARN.A?? 42
External File - TOOSLOW.ASC 43
External File - TRASHCAN.ASC 43
External File - TRASHCAN.CTL 41
External File - USER.BBS 30
External File - WELCOME.A?? 43
External File - XFERHELP.A?? 43
External Program - DSZ 1
External Program - ECHOGEN 49
External Program - ECHOKDUP 54
External Program - Full Screen Editor 8
External Program - Full Screen Editor F-1
External Program - MAILSCAN 48
External Program - MAILTOSS 49
External Program - MENUEDIT 12
External Program - MSGPACK 35
External Program - MSGUTILS 34
External Program - QNODE 46
External Program - SETNUM 39
External Program - SHEDIT 1
External Program - USEREDIT 31
External Program - USERPACK 33
External Program - USERSORT 34
External Program - WXMODEM 1
F - K
FLSEARCH.CTL 39
QuickBBS Index - Page Index-2
Full Screen Editor F-1
Full Screen Editor Toggle 33
Full Screen Message Editor 1
GOODBYE.A?? 41
Hang Up 36
Hang Up C-1
Help Menu 37
Help Menu C-1
Ignore Download Hours 33
Jump to DOS 36
Jump to DOS C-1
Keys That Work While A User is On Line C-1
L - M
LASTREAD.BBS 6
LIMITS.CTL 40
Lockout the user 36
Lockout the User C-1
Logging on in Local Mode When QuickBBS is Running 36
Logging to the Printer 36
Logging to the Printer C-1
LOGO.ASC 41
MAILSCAN 48
MAILTOSS 49
Marking a User as No-Kill 33
MAXPAGE.A?? 41
Memory Requirements Intro-3
Menu - Appending lines 14
Menu - Displaying the Time Remaining 14
Menu - Duplicating The Examples 30
Menu - Example of A File Access Menu 27
Menu - Example of A Logoff Menu 26
Menu - Example of A Message Board Menu 25
Menu - Example of A Top Menu 29
Menu - Highlighting Characters 13
Menu Types and Optional Data D-1
MENUEDIT 12
Message Board - Configuration 2
Message File - Cleaning 34
Message File - Packing 35
MSGPACK 35
MSGUTILS 34
N - P
Net Mail - Determining when user entered 48
Net Mail Credit - Setting 31
Net Mail Overview 45
Net/Node Number - How to Get One 45
NEWS.A?? 41
NEWUSER.Q-A 17
NEWUSER1.ASC 41
NEWUSER2.A?? 42
QuickBBS Index - Page Index-3
NO300.ASC 42
Nodediff - Compiling 46
Nodelist - Compiling 46
Non Continuous Mailers 47
NOTAVAIL.A?? 42
NOTFOUND.ASC 42
Origin Lines - Using Different Lines For Each Echo 39
PAGEABRT.A?? 42
PAGED.A?? 42
Parameters - Misc. 2
Parameters - Modem 2
Parameters - New Users 2
Parameters - System - Displaying 44
Parameters - User - Displaying 44
PASSWORD.A?? 42
Phone Numbers - Unacceptable 40
PHONENUM.CTL 40
PRIVATE.ASC 42
Q - S
QNODE 46
Questionnaire Command Language 17
QuickBBS and Points 49
QuickBBS Batch File Without A Mailer A-17
QuickBBS Sysop Echo 55
Ram Drives Intro-4
READHELP.A?? 42
SEADog - Exit option A-14
SEADog - Spawn Option A-12
SEC#.A?? 42
Sercuity Level - Setting 31
SETNUM.EXE 39
Setting User Time Limits 40
Shareware Intro-1
SHEDIT 1
Spawn BBS 47
SYSINFO.BBS 39
System Paths 2
T-Z
TIMELOG.BBS 38
TIMEWARN.A?? 42
TOOSLOW.ASC 43
TRASHCAN.ASC 43
TRASHCAN.CTL 41
User File - Editing 31
User File - Packing 33
User File - Sorting 34
User Names - Unacceptable 41
USER.BBS 30
USEREDIT 31
USERPACK 33
QuickBBS Index - Page Index-4
Users - Deleting 33
Users - Printing 33
USERSORT 34
WELCOME.A?? 43
Windowed XModem Protocol 1
WXMODEM 1
XFERHELP.A?? 43
Zmodem Protocol 1
QuickBBS Index - Page Index-5